MCP Server Fetch Python

🚀 mcp-server-fetch-python

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

✨ 主な機能

ツール

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

• get-raw-text：ブラウザでレンダリングすることなく、URLから直接生のテキストコンテンツを抽出します。

  • パラメータ：
    • url：対象WebページのURL（必須）
  • 構造化データ形式や迅速なアクセスが必要な場合に最適です。

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

  • パラメータ：
    • url：対象WebページのURL（必須）
  • 現代の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ツールで使用するため、有効な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",        
    }
  }
}

ローカルインストール

また、サーバーをローカルにインストールして実行することもできます。

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

🔧 開発

デバッグ

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