web-fetch-mcp

Web Fetch MCP Server

English | 中文

一个 Model Context Protocol（MCP）服务，提供网页内容抓取、摘要、比较和提取功能。

功能

• 三种核心工具：提供 summarize_web、compare_web 和 extract_web，用于多样化的网页内容处理。
• 支持多个 URL：单次请求最多处理 20 个 URL。
• 内容转换：将 HTML 转换为整洁、易读的文本，并自动将 GitHub /blob/ URL 解析为对应的原始内容 URL。
• 安全可靠：通过拦截对私有 IP 地址的请求，防范服务器端请求伪造（SSRF）。
• 可配置：允许设置超时时间和内容长度限制，以便管理性能。

安装

从 npm 全局安装此服务：

npm install -g web-fetch-mcp

MCP Agent 配置

若要将此服务与支持 Model Context Protocol 的 AI Agent 搭配使用，请将以下配置添加到 Agent 的设置中。配置完成后，Agent 即可调用此服务提供的工具。

**重要：**必须提供有效的 Gemini API 密钥，服务才能正常运行。

如果已全局安装该软件包：

{
  "mcpServers": {
    "web-fetch-mcp": {
      "type": "stdio",
      "command": "web-fetch-mcp",
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      }
    }
  }
}

注意：如果遇到网络访问问题（例如无法连接到 Gemini），可以配置环境变量 HTTPS_PROXY 和 HTTP_PROXY。默认使用 gemini-2.5-flash 模型，与 Gemini-CLI 保持一致。

如果从本地克隆运行：

{
  "mcpServers": {
    "web-fetch-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/web-fetch-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY"
      }
    }
  }
}

工具参考

此服务提供以下工具：

• summarize_web：总结一个或多个 URL 的内容。
• compare_web：比较多个 URL 的内容。
• extract_web：使用自然语言提示词从网页内容中提取特定信息。

工具调用示例

若要使用工具，Agent 应发起 callTool 请求，并指定工具名称和 prompt：

{
  "tool": "summarize_web",
  "arguments": {
    "prompt": "Summarize the main points from https://example.com/article"
  }
}

开发者指南

如果你希望参与此服务的开发：

1. 克隆代码仓库：

   git clone https://github.com/your-username/web-fetch-mcp.git
   cd web-fetch-mcp
   

2. 安装依赖：

   npm install
   

3. 以开发模式运行：

   npm run dev
   

4. 构建生产版本：

   npm run build