MCP NPX Fetch

MCP NPX Fetch

---

🚀 功能

• 🌐 通用内容获取：支持 HTML、JSON、纯文本和 Markdown 格式
• 🔒 自定义请求头支持：为请求添加身份验证信息和自定义请求头
• 🛠 内置转换功能：自动在不同格式之间转换
• ⚡ 高性能：使用现代 JavaScript 特性构建，并针对速度进行了优化
• 🔌 兼容 MCP：可与 Claude Desktop 和其他 MCP 客户端无缝集成
• 🎯 类型安全：使用 TypeScript 编写，并提供完整的类型定义

📦 安装

全局安装 NPM 包

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

使用 NPX 直接运行

npx @tokenizin/mcp-npx-fetch

📚 文档

可用工具

fetch_html

获取并返回任意 URL 的原始 HTML 内容。

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

fetch_json

获取并解析任意 URL 的 JSON 数据。

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

fetch_txt

获取并返回干净的纯文本内容，同时移除 HTML 标签和脚本。

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

fetch_markdown

获取内容并将其转换为格式良好的 Markdown。

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

🔧 用法

CLI 用法

直接启动 MCP 服务：

mcp-npx-fetch

或通过 npx 启动：

npx @tokenizin/mcp-npx-fetch

集成 Claude Desktop

1. 找到 Claude Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

2. 将以下配置添加到 mcpServers 对象中：

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

💻 本地开发

1. 克隆代码库：

git clone https://github.com/tokenizin-agency/mcp-npx-fetch.git
cd mcp-npx-fetch

2. 安装依赖：

npm install

3. 启动开发模式：

npm run dev

4. 运行测试：

npm test

🛠 技术栈

• Model Context Protocol SDK - MCP 核心功能
• JSDOM - HTML 解析和处理
• Turndown - HTML 转 Markdown
• TypeScript - 类型安全和现代 JavaScript 特性
• Zod - 运行时类型验证

🤝 贡献

欢迎贡献！欢迎提交 Pull Request。对于重大变更，请先提交 issue，讨论你希望进行的更改。

1. Fork 代码库
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 提交 Pull Request

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

---