Radio France Podcast Explorer MCP

🚀 フランス放送協会ポッドキャストエクスプローラーMCPサーバー

このサーバーは、モデル制御プロトコル（MCP）を使用しており、ClaudeのようなAIアシスタントがフランス放送協会（Radio France）のポッドキャスト、音声再生、その他のコンテンツを検索および探索できるようにします。

✨ 主な機能

• テーマ別にポッドキャストとエピソードを検索する
• 特定のフランス放送協会のテレビチャンネルの番組情報を取得する
• 分類（テーマ、カテゴリ、タグ）で整理されたコンテンツを閲覧する
• 詳細なポッドキャストとエピソードの情報を取得する
• 自然言語のクエリを処理して関連するコンテンツを見つける
• 音声コンテンツのメタデータとストリーミングURLを取得する

📦 インストール

必要条件

• Python 3.7以上
• フランス放送協会の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  # Windowsの場合は：venv\Scripts\activate
   

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

   pip install -r requirements.txt
   

4. .envファイルを作成し、フランス放送協会のAPIキーを追加します：

   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インターフェイスが開きます。

高度な使用法

Claudeに対して以下のようなクエリを投げることができます：

1. “フランスの歴史に関するポッドキャストを探して”
2. “France Interで現在何が放送されている？”
3. “ヨーロッパの政治に関するエピソードを検索”
4. “フランス放送協会の異なるポッドキャストカテゴリは何ですか？”
5. “このURLの音声コンテンツの情報を取得”

🔧 技術詳細

フランス放送協会のAPIは、分類ベースの方法を使用しています：

1. 分類：コンテンツを整理するためのカテゴリ、タグ、テーマ
2. Diffusions：分類に関連付けられたコンテンツ項目（エピソード、番組）
3. ブランド：ポッドキャストとシリーズ番組
4. グリッド：テレビチャンネルの番組表

📚 ドキュメント

詳細情報については、以下を参照してください：

• 使用ガイド - サーバーの詳細な使用方法
• API情報 - フランス放送協会APIの詳細情報

🤝 貢献

貢献を歓迎します！自由にプルリクエストを送信してください。

📄 ライセンス

MITライセンスの下で公開されています。