MCP Server Fetch Python

🚀 mcp-server-fetch-python

mcp-server-fetch-python 是一個 MCP 服務器，用於抓取網絡內容並將其轉換為各種格式。它提供了全面的工具，可從網頁中提取內容，支持使用 JavaScript 渲染的內容和媒體文件，為網絡內容處理提供了強大的支持。

✨ 主要特性

工具

該服務器提供了四個專業工具，滿足不同場景下的內容提取需求：

• get-raw-text：無需瀏覽器渲染，直接從 URL 提取原始文本內容。

  • 參數：
    • url：目標網頁的 URL（必需）
  • 適用場景：最適合處理結構化數據格式或需要快速訪問的情況。

• get-rendered-html：使用無頭瀏覽器獲取完全渲染的 HTML 內容。

  • 參數：
    • url：目標網頁的 URL（必需）
  • 適用場景：對於現代網絡應用和單頁面應用（SPA），此工具必不可少。

• get-markdown：將網頁內容轉換為格式美觀的 Markdown。

  • 參數：
    • url：目標網頁的 URL（必需）
  • 優勢：在保持結構元素的同時提供乾淨、可讀的文本輸出。

• get-markdown-from-media：對媒體文件進行 AI 驅動的內容提取。

  • 參數：
    • url：目標媒體文件的 URL（圖像、視頻）（必需）
  • 技術支持：利用計算機視覺和 OCR 技術進行內容分析。
  • 注意事項：需要設置有效的 OPENAI_API_KEY 環境變量；如果未設置 API 密鑰或處理媒體文件時出現問題，將返回錯誤消息。

📦 安裝指南

本地安裝

您可以本地安裝並運行該服務器，具體步驟如下：

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

💻 使用示例

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

本地安裝後配置

將以下配置添加到 Claude Desktop 配置文件中：

"mcpServers": {
  "mcp-server-fetch-python": {
    "command": "uv",
    "args": [
      "--directory",
      "path\\to\\mcp-server-fetch-python",  # 請替換為實際的克隆倉庫路徑
      "run",
      "mcp-server-fetch-python"
    ]
  }
}

🔧 技術細節

環境變量

可以配置以下環境變量：

• OPENAI_API_KEY：用於get-markdown-from-media工具，需要設置有效的 OpenAI API 密鑰。
• 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