MCP NPX Fetch

<div align="center">

一个强大的 MCP 服务器，可以轻松地获取和转换 Web 内容为各种格式（HTML、JSON、Markdown、纯文本）。

安装 • 特性 • 用法 • 文档 • 贡献

</div>

<a href="https://glama.ai/mcp/servers/m2a0ue08n2"><img width="380" height="200" src="https://glama.ai/mcp/servers/m2a0ue08n2/badge" alt="NPX Fetch MCP server" /></a>

---

🚀 特性

• 🌐 通用内容获取: 支持 HTML、JSON、纯文本和 Markdown 格式
• 🔒 自定义 Header 支持: 为您的请求添加身份验证和自定义 header
• 🛠 内置转换: 自动在格式之间转换
• ⚡ 高性能: 使用现代 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;     // 必需: 目标 URL
  headers?: {      // 可选: 自定义请求 header
    [key: string]: string;
  };
}

fetch_json

从任何 URL 获取并解析 JSON 数据。

{
  url: string;     // 必需: 目标 URL
  headers?: {      // 可选: 自定义请求 header
    [key: string]: string;
  };
}

fetch_txt

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

{
  url: string;     // 必需: 目标 URL
  headers?: {      // 可选: 自定义请求 header
    [key: string]: string;
  };
}

fetch_markdown

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

{
  url: string;     // 必需: 目标 URL
  headers?: {      // 可选: 自定义请求 header
    [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 文件。

---

<div align="center"> 用 ❤️ 由 <a href="https://github.com/tokenizin-agency">PT Tokenizin Technology Agency</a> 制作 </div>