PodCrawlerMCP

PodCrawlerMCP

ウェブクローリングを通じてポッドキャストを探すための MCP（Model Context Protocol）サーバーです。PodCrawlerMCP は、RSS フィードを求めてウェブをクロールすることで、AI アシスタントが特定のトピックに関するポッドキャストのエピソードを見つけられるようにします。

特長

• 🕸️ ポッドキャストディレクトリをクロールして RSS フィードを見つけます
• 🎙️ RSS フィードを解析してエピソードのデータを抽出します
• 🔍 トピックまたはドメインでエピソードを絞り込みます
• 🔌 MCP ツールを通じて機能を提供します
• 🤖 Claude などの AI アシスタントとシームレスに連携します

インストール

pip install podcrawler-mcp

または Poetry を使用します：

poetry add podcrawler-mcp

クイックスタート

サーバーを直接実行します：

python -m podcrawler.server

または Python コード内で実行します：

from podcrawler import PodCrawlerServer

server = PodCrawlerServer()
server.run()

Claude Desktop との連携

Claude Desktop の設定に追加します：

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

利用可能なツール

discover_podcasts

特定のトピックに関するポッドキャストを見つけます。

パラメーター：

• topic（文字列）：検索するトピック（例：「technology」、「history」）
• max_results（整数、任意）：返す結果の最大数（デフォルト：10）

使用例：

ブラックホールに関する科学ポッドキャストにはどのようなものがありますか？

プロジェクト構成

podcrawler-mcp/
├── podcrawler/                # Main package
│   ├── __init__.py            # Package initialization
│   ├── server.py              # MCP server implementation
│   ├── tools/                 # MCP tools
│   │   ├── __init__.py
│   │   └── discovery.py       # Podcast discovery tool
│   ├── crawler/               # Web crawling components
│   │   ├── __init__.py
│   │   ├── spider.py          # Web crawler implementation
│   │   └── parser.py          # RSS feed parser
│   └── utils/                 # Utility functions
│       ├── __init__.py
│       ├── filtering.py       # Topic filtering utilities
│       └── formatting.py      # Output formatting utilities
├── tests/                     # Tests
│   ├── __init__.py
│   └── test_server.py         # Server tests
├── examples/                  # Usage examples
│   └── basic_discovery.py     # Basic discovery example
├── pyproject.toml             # Project configuration
├── README.md                  # Project documentation
├── LICENSE                    # MIT License
└── CONTRIBUTING.md            # Contribution guidelines

開発

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 ファイルをご覧ください。