Jmh108 MCP Server Readability Python

🚀 Mozilla 可读性解析器 MCP サーバー

このサーバーはPythonに基づく Model Context Protocol (MCP) の実装で、ウェブページの内容を抽出し、大規模言語モデルで処理しやすいクリーンなMarkdown形式に変換します。

🚀 クイックスタート

サーバーの起動

fastmcp run server.py

サンプルリクエスト

curl -X POST http://localhost:8000/tools/extract_content \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

✨ 主な機能

• 広告、ナビゲーションバー、フッターなどの不要なコンテンツを削除します。
• クリーンなHTMLを適切な形式のMarkdownに変換します。
• エラーを穏やかに処理します。
• 大規模言語モデル（LLM）の処理に最適化されています。
• 軽量で高速です。

📚 詳細ドキュメント

なぜ直接スクレイピングしないのか？

単純なスクレイピングリクエストとは異なり、このサーバーは以下のような機能を持っています。

• 読みやすさアルゴリズムを使用して、関連するコンテンツのみを抽出します。
• 広告、ポップアップ、ナビゲーションメニューなどのノイズを排除します。
• 不要なHTML/CSSを削除することで、トークンの使用量を削減します。
• 一貫したMarkdown形式を提供し、LLMの処理効果を向上させます。
• 動的コンテンツを含む複雑なウェブページを処理します。

📦 インストール

リポジトリのクローン

git clone https://github.com/jmh108/MCP-server-readability-python.git
cd MCP-server-readability-python

仮想環境の作成とアクティベート

python -m venv venv
source venv/bin/activate  # Windowsの場合は：venv\Scripts\activate

依存関係のインストール

pip install -r requirements.txt

💻 使用例

基本的な使用法

curl -X POST http://localhost:8000/tools/extract_content \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

高度な使用法

このサーバーは、MCP設定ファイルで構成することができます。以下の内容をMCP設定ファイルに追加します。

{
  "mcpServers": {
    "readability": {
      "command": "fastmcp",
      "args": ["run", "server.py"],
      "env": {}
    }
  }
}

その後、MCPプロトコルを介してサーバーを起動し、parse ツールを使用してアクセスすることができます。

📚 ドキュメント

extract_content ツール

ウェブページの内容をスクレイピングし、クリーンなMarkdownに変換します。

パラメータ:

{
  "url": {
    "タイプ": "文字列",
    "説明": "解析するウェブサイトのURL",
    "必須": true
  }
}

戻り値:

{
  "content": "Markdown 内容..."
}

🔧 技術詳細

依存関係

• readability-lxml - コンテンツ抽出
• html2text - HTMLをMarkdownに変換
• beautifulsoup4 - DOM解析
• requests - HTTPリクエスト

📄 ライセンス

MITライセンス - 詳細は LICENSE を参照してください。