{"versions":{"1.0.0":{"name":"@tokenizin/mcp-npx-fetch","version":"1.0.0","description":"A CLI tool for fetching and processing content using the Model Context Protocol","type":"module","main":"dist/index.js","bin":{"mcp-npx-fetch":"dist/index.js"},"homepage":"https://github.com/tokenizin-agency/mcp-npx-fetch","repository":{"type":"git","url":"git+https://github.com/tokenizin-agency/mcp-npx-fetch.git"},"license":"MIT","author":{"name":"TokiDev","url":"tokenizin.com"},"scripts":{"build":"tsc && shx chmod +x dist/*.js","prepare":"npm run build","dev":"tsc --watch","start":"node dist/index.js","test":"jest"},"keywords":["mcp","model-context-protocol","cli","fetch","content-processing"],"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","jsdom":"^25.0.1","turndown":"^7.2.0","zod":"^3.24.1"},"devDependencies":{"@types/jest":"^29.5.14","@types/jsdom":"^21.1.7","@types/node":"^22.10.2","@types/turndown":"^5.0.5","jest":"^29.7.0","shx":"^0.3.4","ts-jest":"^29.2.5","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"@tokenizin/mcp-npx-fetch@1.0.0","gitHead":"c0499be179b1bfa641c8478fdfae6ac43483470b","bugs":{"url":"https://github.com/tokenizin-agency/mcp-npx-fetch/issues"},"_nodeVersion":"20.18.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-yO0EWFe9NaWjSZmeSBja2jeOEKBKjVA/MkbBBVO9aYu+h3QjZ/JLELLQnSGDEkyzlNFr0zMH/PmOVb8vfW8OaA==","shasum":"ca24155b66b337431ee8de1af86cd5cc1f63e37c","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/@tokenizin/mcp-npx-fetch/-/mcp-npx-fetch-1.0.0.tgz","fileCount":6,"unpackedSize":15395,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDTvRrHY357XME2kJS7fTEEkYDiLIxQ7BIPguYX1meuhwIhAKuQNLZU1hAMGoqlGuG9dslt/D2cGjYi4gI2ikSurvdB"}],"size":4808},"_npmUser":{"name":"anonymous","email":"sascha1337@tokenizin.com"},"directories":{},"maintainers":[{"name":"anonymous","email":"sascha1337@tokenizin.com"},{"name":"anonymous","email":"devs@tokenizin.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-npx-fetch_1.0.0_1735205351562_0.3448571767353239"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2024-12-26T09:29:11.740Z","publish_time":1735205351740,"_source_registry_name":"default","contributors":[]}},"dist-tags":{"latest":"1.0.0"},"name":"@tokenizin/mcp-npx-fetch","time":{"created":"2024-12-26T09:38:12.305Z","modified":"2024-12-26T09:38:13.131Z","1.0.0":"2024-12-26T09:29:11.740Z"},"readme":"# MCP NPX Fetch\n\n\n\n[](https://www.npmjs.com/package/@tokenizin/mcp-npx-fetch)\n[](https://opensource.org/licenses/MIT)\n[](https://www.typescriptlang.org/)\n[](https://github.com/modelcontextprotocol)\n\nA powerful MCP server for fetching and transforming web content into various formats (HTML, JSON, Markdown, Plain Text) with ease.\n\n[Installation](#installation) •\n[Features](#features) •\n[Usage](#usage) •\n[Documentation](#documentation) •\n[Contributing](#contributing)\n\n
\n\n![\"NPX](\"https://glama.ai/mcp/servers/m2a0ue08n2/badge\")
\n\n---\n\n## 🚀 Features\n\n- 🌐 **Universal Content Fetching**: Supports HTML, JSON, plain text, and Markdown formats\n- 🔒 **Custom Headers Support**: Add authentication and custom headers to your requests\n- 🛠 **Built-in Transformations**: Automatic conversion between formats\n- ⚡ **High Performance**: Built with modern JavaScript features and optimized for speed\n- 🔌 **MCP Compatible**: Seamlessly integrates with Claude Desktop and other MCP clients\n- 🎯 **Type-Safe**: Written in TypeScript with full type definitions\n\n## 📦 Installation\n\n### NPM Global Installation\n\n```bash\nnpm install -g @tokenizin/mcp-npx-fetch\n\n```\n\n### Direct Usage with NPX\n\n```bash\nnpx @tokenizin/mcp-npx-fetch\n```\n\n## 📚 Documentation\n\n### Available Tools\n\n#### `fetch_html`\n\nFetches and returns raw HTML content from any URL.\n\n```typescript\n{\n url: string; // Required: Target URL\n headers?: { // Optional: Custom request headers\n [key: string]: string;\n };\n}\n```\n\n#### `fetch_json`\n\nFetches and parses JSON data from any URL.\n\n```typescript\n{\n url: string; // Required: Target URL\n headers?: { // Optional: Custom request headers\n [key: string]: string;\n };\n}\n```\n\n#### `fetch_txt`\n\nFetches and returns clean plain text content, removing HTML tags and scripts.\n\n```typescript\n{\n url: string; // Required: Target URL\n headers?: { // Optional: Custom request headers\n [key: string]: string;\n };\n}\n```\n\n#### `fetch_markdown`\n\nFetches content and converts it to well-formatted Markdown.\n\n```typescript\n{\n url: string; // Required: Target URL\n headers?: { // Optional: Custom request headers\n [key: string]: string;\n };\n}\n```\n\n## 🔧 Usage\n\n### CLI Usage\n\nStart the MCP server directly:\n\n```bash\nmcp-npx-fetch\n```\n\nOr via npx:\n\n```bash\nnpx @tokenizin/mcp-npx-fetch\n```\n\n### Claude Desktop Integration\n\n1. Locate your Claude Desktop configuration file:\n\n - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n - Windows: `%APPDATA%/Claude/claude_desktop_config.json`\n - Linux: `~/.config/Claude/claude_desktop_config.json`\n\n2. Add the following configuration to your `mcpServers` object:\n\n```json\n{\n \"mcpServers\": {\n \"fetch\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@tokenizin/mcp-npx-fetch\"],\n \"env\": {}\n }\n }\n}\n```\n\n## 💻 Local Development\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/tokenizin-agency/mcp-npx-fetch.git\ncd mcp-npx-fetch\n```\n\n2. Install dependencies:\n\n```bash\nnpm install\n```\n\n3. Start development mode:\n\n```bash\nnpm run dev\n```\n\n4. Run tests:\n\n```bash\nnpm test\n```\n\n## 🛠 Technical Stack\n\n- [Model Context Protocol SDK](https://github.com/modelcontextprotocol/sdk) - Core MCP functionality\n- [JSDOM](https://github.com/jsdom/jsdom) - HTML parsing and manipulation\n- [Turndown](https://github.com/mixmark-io/turndown) - HTML to Markdown conversion\n- [TypeScript](https://www.typescriptlang.org/) - Type safety and modern JavaScript features\n- [Zod](https://github.com/colinhacks/zod) - Runtime type validation\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n","users":{}}