mcp npx fetch

Local 2025-08-31 23:13:36 0
Browser Automation @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.

[![npm version](https://img.shields.io/npm/v/@tokenizin/mcp-npx-fetch.svg)](https://www.npmjs.com/package/@tokenizin/mcp-npx-fetch) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/) [![Model Context Protocol](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://github.com/modelcontextprotocol) A powerful MCP server for fetching and transforming web content into various formats (HTML, JSON, Markdown, Plain Text) with ease. [Installation](#installation) • [Features](#features) • [Usage](#usage) • [Documentation](#documentation) • [Contributing](#contributing)

NPX Fetch MCP server

? 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

npm install -g @tokenizin/mcp-npx-fetch

Direct Usage with NPX

npx @tokenizin/mcp-npx-fetch

? Documentation

Available Tools

fetch_html

Fetches and returns raw HTML content from any URL.

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

fetch_json

Fetches and parses JSON data from any URL.

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

fetch_txt

Fetches and returns clean plain text content, removing HTML tags and scripts.

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

fetch_markdown

Fetches content and converts it to well-formatted Markdown.

{
  url: string;     // Required: Target URL
  headers?: {      // Optional: Custom request headers
    [key: string]: string;
  };
}

? Usage

CLI Usage

Start the MCP server directly:

mcp-npx-fetch

Or via npx:

npx @tokenizin/mcp-npx-fetch

Claude Desktop Integration

  1. Locate your Claude Desktop configuration file:

  2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  3. Windows: %APPDATA%/Claude/claude_desktop_config.json

  4. Linux: ~/.config/Claude/claude_desktop_config.json

  5. Add the following configuration to your mcpServers object:

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["-y", "@tokenizin/mcp-npx-fetch"],
      "env": {}
    }
  }
}

? Local Development

  1. Clone the repository:
git clone https://github.com/tokenizin-agency/mcp-npx-fetch.git
cd mcp-npx-fetch
  1. Install dependencies:
npm install
  1. Start development mode:
npm run dev
  1. Run tests:
npm test

? Technical Stack

? Contributing

Contributions 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.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

? License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ by PT Tokenizin Technology Agency 
[
  {
    "description": "Fetch a website and return the content as HTML",
    "inputSchema": {
      "properties": {
        "headers": {
          "description": "Optional headers to include in the request",
          "type": "object"
        },
        "url": {
          "description": "URL of the website to fetch",
          "type": "string"
        }
      },
      "required": [
        "url"
      ],
      "type": "object"
    },
    "name": "fetch_html"
  },
  {
    "description": "Fetch a website and return the content as Markdown",
    "inputSchema": {
      "properties": {
        "headers": {
          "description": "Optional headers to include in the request",
          "type": "object"
        },
        "url": {
          "description": "URL of the website to fetch",
          "type": "string"
        }
      },
      "required": [
        "url"
      ],
      "type": "object"
    },
    "name": "fetch_markdown"
  },
  {
    "description": "Fetch a website, return the content as plain text (no HTML)",
    "inputSchema": {
      "properties": {
        "headers": {
          "description": "Optional headers to include in the request",
          "type": "object"
        },
        "url": {
          "description": "URL of the website to fetch",
          "type": "string"
        }
      },
      "required": [
        "url"
      ],
      "type": "object"
    },
    "name": "fetch_txt"
  },
  {
    "description": "Fetch a JSON file from a URL",
    "inputSchema": {
      "properties": {
        "headers": {
          "description": "Optional headers to include in the request",
          "type": "object"
        },
        "url": {
          "description": "URL of the JSON to fetch",
          "type": "string"
        }
      },
      "required": [
        "url"
      ],
      "type": "object"
    },
    "name": "fetch_json"
  }
]