🚀 mcp-server-fetch-python

mcp-server-fetch-python 是一个 MCP 服务器，用于抓取网络内容并将其转换为多种格式。该服务器提供了全面的工具，可从网页中提取内容，支持 JavaScript 渲染的内容和媒体文件。

🚀 快速开始

本地安装

您可以本地安装并运行该服务器，操作步骤如下：

git clone https://github.com/tatn/mcp-server-fetch-python.git
cd mcp-server-fetch-python
uv sync
uv build

然后将以下配置添加到 Claude Desktop 配置文件中：

"mcpServers": {
  "mcp-server-fetch-python": {
    "command": "uv",
    "args": [
      "--directory",
      "path\\to\\mcp-server-fetch-python",  # 请替换为实际克隆仓库的路径
      "run",
      "mcp-server-fetch-python"
    ]
  }
}

Claude Desktop

要在 Claude Desktop 中使用，请添加服务器配置： 在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "mcp-server-fetch-python": {
    "command": "uvx",
    "args": [
      "mcp-server-fetch-python"
    ]
  }
}

✨ 主要特性

工具

该服务器提供了四个专用工具：

• get-raw-text：直接从 URL 提取原始文本内容，无需浏览器渲染。
  • 参数：
    • url：目标网页的 URL（必需）
  • 适用场景：最适合处理结构化数据格式或需要快速访问的情况。
• get-rendered-html：使用无头浏览器获取完全渲染的 HTML 内容。
  • 参数：
    • url：目标网页的 URL（必需）
  • 适用场景：对于现代 Web 应用程序和 SPA，该工具必不可少。
• get-markdown：将网页内容转换为格式良好的 Markdown。
  • 参数：
    • url：目标网页的 URL（必需）
  • 优势：保留结构元素的同时提供干净、可读的文本输出。
• get-markdown-from-media：对媒体文件进行 AI 驱动的内容提取。
  • 参数：
    • url：目标媒体文件的 URL（图像、视频）（必需）
  • 技术支持：利用计算机视觉和 OCR 技术分析视觉内容。
  • 注意事项：需要将有效的 OPENAI_API_KEY 设置为环境变量；如果未设置 API 密钥或处理媒体文件时出现问题，将返回错误消息。

📚 详细文档

环境变量

可以配置以下环境变量：

• OPENAI_API_KEY：使用 get-markdown-from-media 工具时必需。此密钥用于 AI 驱动的图像分析和内容提取。
• PYTHONIOENCODING：如果遇到字符编码问题，设置为 "utf-8"。
• MODEL_NAME：指定要使用的模型名称，默认为 "gpt-4o"。

"mcpServers": {
  "mcp-server-fetch-python": {
    "command": "uvx",
    "args": [
      "mcp-server-fetch-python"
    ],
    "env": {
        "OPENAI_API_KEY": "sk-****",
        "PYTHONIOENCODING": "utf-8",
        "MODEL_NAME": "gpt-4o",        
    }
  }
}

开发 - 调试

您可以使用 npx 启动 MCP Inspector，使用以下命令：

npx @modelcontextprotocol/inspector uvx mcp-server-fetch-python

npx @modelcontextprotocol/inspector uv --directory path\\to\\mcp-server-fetch-python run mcp-server-fetch-python