Radio France Podcast Explorer MCP

Radio France Podcast Explorer MCP

Claude などの AI アシスタントが、Radio France のポッドキャスト、音声リプレイ、その他のコンテンツを検索・探索できる Model Control Protocol（MCP）サーバーです。

機能

• トピックからポッドキャストやエピソードを検索します
• Radio France の特定の放送局の番組情報を取得します
• 分類体系（テーマ、カテゴリー、タグ）ごとに整理されたコンテンツを探索します
• ポッドキャストやエピソードの詳細情報を取得します
• 自然言語のクエリを処理して、関連するコンテンツを見つけます
• 音声コンテンツのメタデータとストリーミング URL を取得します

必要条件

• Python 3.7+
• Radio France API キー（Radio France Open API から取得できます）

インストール

1. このリポジトリをクローンします：

   git clone https://github.com/infinitimeless/radiofrance-podcast-explorer-mcp.git
   cd radiofrance-podcast-explorer-mcp
   

2. 仮想環境を作成します：

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

4. Radio France API キーを記載した .env ファイルを作成します：

   RADIOFRANCE_API_KEY=your_api_key_here
   

テスト

サーバーを実行する前に、テストを実行してインストールと API キーを確認できます：

python run_tests.py

GraphQL スキーマテストを実行して、API の構造を確認することもできます：

python tests/test_schema.py

サーバーの実行

python server.py

Claude Desktop での使用

このサーバーを Claude Desktop で使用するには：

1. 次の場所にあるファイルを開きます：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. サーバー設定を追加または更新します：

   {
     "mcpServers": {
       "radiofrance": {
         "command": "python",
         "args": ["/absolute/path/to/radiofrance-podcast-explorer-mcp/server.py"],
         "env": {
           "RADIOFRANCE_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

3. ファイルを保存して、Claude Desktop を再起動します

開発時のテスト

MCP Inspector を使用してサーバーをテストできます：

npx @modelcontextprotocol/inspector python server.py

Web インターフェースが開き、サーバーの各ツールを個別にテストできます。

API の構造

Radio France API は、分類体系に基づくアプローチを採用しています：

1. 分類体系：コンテンツを整理するカテゴリー、タグ、テーマ
2. 配信コンテンツ：分類体系に関連付けられたコンテンツ項目（エピソード、番組）
3. ブランド：番組やポッドキャストシリーズ
4. 番組表：放送局の番組スケジュール

ドキュメント

詳しい情報については、以下をご覧ください：

• 使用ガイド - サーバーの使用方法の詳細
• API 情報 - Radio France API に関する情報

Claude へのクエリ例

この MCP サーバーを使用する際、Claude に尋ねられるクエリの例を紹介します：

1. 「フランスの歴史に関するポッドキャストを探して」
2. 「France Inter では今、何が放送されている？」
3. 「ヨーロッパの政治に関するポッドキャストのエピソードを検索して」
4. 「Radio France のポッドキャストにはどんなカテゴリーがある？」
5. 「この URL にある音声コンテンツの情報を教えて」

コントリビューション

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

MIT