Readability (Fetch & Parse)

🚀 Mozilla Readability 解析器 MCP サーバー（Python / FastMCP）

このサーバーは、Model Context Protocol (MCP) に基づいたPython実装で、ウェブページの内容を抽出し、大型言語モデル（LLM）に最適な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の処理フローを最適化します。
• 軽量かつ高速です。

📦 インストール

リポジトリのクローン

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

💻 使用例

基本的な使用法

# サーバーの起動
fastmcp run server.py

# サンプルリクエスト
curl -X POST http://localhost:8000/tools/extract_content \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

📚 ドキュメント

ツールリファレンス

extract_content

ウェブページの内容を取得し、クリーンなMarkdownに変換します。

パラメータ：

{
  "url": {
    "type": "string",
    "description": "解析するウェブサイトのURL",
    "required": true
  }
}

戻り値：

{
  "content": "Markdown形式のコンテンツ..."
}

MCPサーバーの設定

MCP設定ファイルに以下の内容を追加して、サーバーを設定します。

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

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

🔧 技術詳細

依存関係

• readability-lxml：コンテンツの抽出に使用
• Flask：Webサービスの構築に使用
• fastapi：APIインターフェースに使用

貢献と参照

このプロジェクトは、server-moz-readability をベースにしており、emzimmer によって開発されました。（元のREADMEドキュメントは こちら を参照してください。）

このPython実装は、FastMCP 上で動作するように、元の概念を整理して実装しています。

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

単純なスクレイピングリクエストとは異なり、このサーバーは以下のことを行います。

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

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。