tokenizin-agency/mcp-npx-fetch

A powerful MCP server for fetching and transforming web content into various formats (HTML, JSON, Markdown, Plain Text) with ease.
Installation •
Features •
Usage •
Documentation •
Contributing
## 🚀 Features
🌐 Universal Content Fetching: Supports HTML, JSON, plain text, and Markdown formats
🔒 Custom Headers Support: Add authentication and custom headers to your requests
🛠 Built-in Transformations: Automatic conversion between formats
⚡ High Performance: Built with modern JavaScript features and optimized for speed
🔌 MCP Compatible: Seamlessly integrates with Claude Desktop and other MCP clients
🎯 Type-Safe: Written in TypeScript with full type definitions
## 📦 Installation
### NPM Global Installation
bash
npm install -g @tokenizin/mcp-npx-fetch
### Direct Usage with NPX
bash
npx @tokenizin/mcp-npx-fetch
## 📚 Documentation
### Available Tools
#### fetchhtml
Fetches and returns raw HTML content from any URL.
typescript
url: string; // Required: Target URL
headers?: { // Optional: Custom request headers
[key: string]: string;
};
#### fetchjson
Fetches and parses JSON data from any URL.
typescript
url: string; // Required: Target URL
headers?: { // Optional: Custom request headers
[key: string]: string;
};
#### fetchtxt
Fetches and returns clean plain text content, removing HTML tags and scripts.
typescript
url: string; // Required: Target URL
headers?: { // Optional: Custom request headers
[key: string]: string;
};
#### fetchmarkdown
Fetches content and converts it to well-formatted Markdown.
typescript
url: string; // Required: Target URL
headers?: { // Optional: Custom request headers
[key: string]: string;
};
## 🔧 Usage
### CLI Usage
Start the MCP server directly:
bash
mcp-npx-fetch
Or via npx:
bash
npx @tokenizin/mcp-npx-fetch
### Claude Desktop Integration
1. Locate your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%/Claude/claudedesktopconfig.json
Linux: ~/.config/Claude/claudedesktopconfig.json
2. Add the following configuration to your mcpServers object:
json
"mcpServers": {
"fetch": {
"command": "npx",
"args": ["-y", "@tokenizin/mcp-npx-fetch"],
"env": {}
## 💻 Local Development
1. Clone the repository:
bash
git clone https://github.com/tokenizin-agency/mcp-npx-fetch.git
cd mcp-npx-fetch
2. Install dependencies:
bash
npm install
3. Start development mode:
bash
npm run dev
4. Run tests:
bash
npm test
## 🛠 Technical Stack
Model Context Protocol SDK - Core MCP functionality
JSDOM - HTML parsing and manipulation