Tatn 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ツールを使用する際に必須です。このキーは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",  # 実際にクローンしたリポジトリのパスに置き換えてください
      "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