Fetch

🚀 Fetch MCP 服务器

此 MCP 服务器具备强大的网页内容抓取能力，支持 HTML、JSON、纯文本和 Markdown 等多种格式，能满足多样化的内容获取需求。

🚀 快速开始

克隆与安装

1. 克隆仓库。
2. 安装依赖：npm install。
3. 构建服务器：npm run build。

通过 Smithery 安装

若要自动通过 Smithery 安装 fetch-mcp 以供 Claude Desktop 使用，可执行以下命令：

npx -y @smithery/cli install @goswamig/fetch-mcp --client claude

启动服务器

要使用服务器，可直接运行：

npm start

这将启动 Fetch MCP Server 在 stdio 上运行。

与桌面应用程序集成使用

若要在桌面应用中集成此服务器，请在应用的服务器配置中添加以下内容：

{
  "mcpServers": {
    "fetch": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

✨ 主要特性

• 使用现代 fetch API 抓取网页内容，高效且稳定。
• 支持自定义请求头，可根据需求灵活调整请求。
• 提供多种格式的内容，包括 HTML、JSON、纯文本和 Markdown，满足不同场景的内容获取需求。
• 使用 JSDOM 进行 HTML 解析和文本提取，确保内容提取的准确性。
• 使用 TurndownService 进行 HTML 转换为 Markdown，方便内容的格式转换。

📦 安装指南

手动安装

1. 克隆仓库。
2. 执行 npm install 安装依赖。
3. 运行 npm run build 构建服务器。

通过 Smithery 安装

npx -y @smithery/cli install @goswamig/fetch-mcp --client claude

💻 使用示例

基础用法

启动服务器：

npm start

高级用法

在桌面应用中集成服务器，在应用的服务器配置中添加：

{
  "mcpServers": {
    "fetch": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

🔧 技术细节

组件

工具

• fetch_html：用于抓取网站并返回 HTML 内容。输入参数包括必需的 url（要抓取的网站 URL）和可选的 headers（请求中包含的自定义头信息），最终返回网页的原始 HTML 内容。
• fetch_json：从指定 URL 抓取 JSON 文件。输入参数为必需的 url（要抓取的 JSON 的 URL）和可选的 headers（请求中包含的自定义头信息），返回解析后的 JSON 内容。
• fetch_txt：抓取网站并返回纯文本内容（无 HTML）。输入参数有必需的 url（要抓取的网站 URL）和可选的 headers（请求中包含的自定义头信息），返回去除 HTML 标签、脚本和样式的网页文本内容。
• fetch_markdown：抓取网站并返回 Markdown 格式的内容。输入参数为必需的 url（要抓取的网站 URL）和可选的 headers（请求中包含的自定义头信息），返回网页内容转换为 Markdown 格式的结果。

资源

此服务器不提供任何持久资源，其设计目的是按需抓取和转换网页内容。

开发

• 运行 npm run dev 可启动 TypeScript 编译器的监视模式，方便开发过程中的代码修改和编译。
• 使用 npm test 可运行测试套件，确保代码的质量和稳定性。

📄 许可证

此项目根据 MIT License 分发。