mcp-server-fetch-python

mcp-server-fetch-python

用于将网页内容获取并转换为多种格式的 MCP 服务。该服务提供全面的网页内容提取工具，包括对 JavaScript 渲染内容和媒体文件的支持。

功能

工具

该服务提供四种专用工具：

• get-raw-text：直接从 URL 提取原始文本内容，无需浏览器渲染

  • 参数：
    • url：目标网页的 URL（文本、JSON、XML、csv、tsv 等）（必填）
  • 适用于结构化数据格式或需要快速直接访问的场景

• get-rendered-html：使用无头浏览器获取完全渲染的 HTML 内容

  • 参数：
    • url：目标网页的 URL（必填）
  • 对需要 JavaScript 渲染的现代 Web 应用和 SPA 至关重要

• get-markdown：将网页内容转换为格式良好的 Markdown

  • 参数：
    • url：目标网页的 URL（必填）
  • 保留结构元素，同时提供简洁易读的文本输出

• get-markdown-from-media：使用 AI 从媒体文件中提取内容

  • 参数：
    • url：目标媒体文件（图像、视频）的 URL（必填）
  • 利用计算机视觉和 OCR 分析视觉内容
  • 需要在环境变量中设置有效的 OPENAI_API_KEY
  • 如果未设置 API 密钥，或处理媒体文件时出现问题，将返回错误消息

使用方法

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"
    ]
  }
}

环境变量

可配置以下环境变量：

• 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",        
    }
  }
}

本地安装

或者，也可以在本地安装并运行该服务：

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",  # Replace with actual path to the cloned repository
      "run",
      "mcp-server-fetch-python"
    ]
  }
}

开发

调试

你可以使用以下命令通过 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