Podcrawler MCP

🚀 PodcastクローラーMCPサーバー

PodcastクローラーMCPサーバーは、ネットワーククローリングを通じてポッドキャストを発見するためのMCP（モデルコンテキストプロトコル）サーバーです。PodCrawlerMCPを使用すると、AIアシスタントがウェブ上のRSSフィードをクロールして特定のテーマのポッドキャストを見つけることができます。

🚀 クイックスタート

サーバーを直接実行するには、以下のコマンドを使用します。

python -m podcrawler.server

または、Pythonコード内で使用することもできます。

from podcrawler import PodCrawlerServer

server = PodCrawlerServer()
server.run()

✨ 主な機能

• 🕸️ ポッドキャストディレクトリをクロールしてRSSフィードを発見します。
• 🎙️ RSSフィードを解析して番組情報を抽出します。
• 🔍 テーマまたは分野に基づいて番組をフィルタリングします。
• 🔌 MCPツールを介して機能を公開します。
• 🤖 ClaudeなどのAIアシスタントとシームレスに統合されます。

📦 インストール

以下のコマンドを使用して、pipでインストールすることができます。

pip install podcrawler-mcp

または、Poetryを使用する場合は、以下のコマンドを実行します。

poetry add podcrawler-mcp

📚 ドキュメント

Claude Desktopとの統合

Claude Desktopの設定に以下の内容を追加します。

{
  "mcpServers": {
    "podcrawler": {
      "command": "python",
      "args": ["-m", "podcrawler.server"]
    }
  }
}

利用可能なツール

discover_podcasts

テーマに基づいてポッドキャストを発見します。

パラメータ:

• topic (文字列): 検索するテーマ（例: "技術", "歴史"）
• max_results (整数、オプション): 返す最大結果数（デフォルト: 10）

使用例: 「黑洞に関する科学ポッドキャストはどれ？」

プロジェクト構造

podcrawler-mcp/
├── podcrawler/                # メインパッケージ
│   ├── __init__.py            # パッケージ初期化
│   ├── server.py              # MCPサーバーの実装
│   ├── tools/                 # MCPツール
│   │   ├── __init__.py
│   │   └── discovery.py       # ポッドキャスト発見ツール
│   ├── crawler/               # ネットワーククローリングコンポーネント
│   │   ├── __init__.py
│   │   ├── spider.py          # ネットワーククローラーの実装
│   │   └── parser.py          # RSSフィード解析器
│   └── utils/                 # ユーティリティ関数
│       ├── __init__.py
│       ├── filtering.py       # テーマフィルタリングユーティリティ
│       └── formatting.py      # 出力フォーマットユーティリティ
├── tests/                     # テスト
│   ├── __init__.py
│   └── test_server.py         # サーバーテスト
├── examples/                  # 使用例
│   └── basic_discovery.py     # 基本的な発見例
├── pyproject.toml             # プロジェクト設定
├── README.md                  # プロジェクトドキュメント
├── LICENSE                    # MITライセンス
└── CONTRIBUTING.md            # コントリビューションガイド

開発手順

1. リポジトリをクローンします。

git clone https://github.com/infinitimeless/podcrawler-mcp.git
cd podcrawler-mcp

2. Poetryを使用して依存関係をインストールします。

poetry install

3. テストを実行します。

poetry run pytest

コントリビューション

コントリビューションは大歓迎です！詳細については、CONTRIBUTING.mdを参照してください。

📄 ライセンス

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