mcp-server-fetch-python

mcp-server-fetch-python

Web コンテンツを取得し、さまざまな形式に変換する MCP サーバーです。このサーバーは、JavaScript でレンダリングされたコンテンツやメディアファイルのサポートなど、Web ページからコンテンツを抽出するための包括的なツールを提供します。

特徴

ツール

このサーバーは、4 つの専用ツールを提供します。

• get-raw-text：ブラウザーでレンダリングせずに、URL から生のテキストコンテンツを直接抽出します

  • 引数：
    • url：対象 Web ページの URL（text、JSON、XML、csv、tsv など）（必須）
  • 構造化データ形式や、迅速かつ直接的なアクセスが必要な場合に最適です

• get-rendered-html：ヘッドレスブラウザーを使って、完全にレンダリングされた HTML コンテンツを取得します

  • 引数：
    • url：対象 Web ページの URL（必須）
  • JavaScript によるレンダリングが必要な最新の Web アプリケーションや SPA に不可欠です

• get-markdown：Web ページのコンテンツを、適切に書式設定された Markdown に変換します

  • 引数：
    • url：対象 Web ページの 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