Radio France Podcast Explorer MCP

🚀 法國廣播公司播客探索器 MCP 服務器

本項目是一個模型控制協議（MCP）服務器，它能讓像Claude這樣的AI助手搜索並探索法國廣播公司（Radio France）的播客、音頻重放及其他內容，為用戶獲取相關音頻資源提供了便利。

🚀 快速開始

本服務器允許AI助手搜索並探索法國廣播公司的各類音頻內容。開始使用前，請確保滿足以下需求並完成安裝步驟。

✨ 主要特性

• 按主題搜索：可按主題搜索播客和集數。
• 節目信息獲取：能獲取特定Radio France電視頻道的節目信息。
• 分類瀏覽：支持瀏覽按分類（主題、類別、標籤）組織的內容。
• 詳細信息查詢：可獲取詳細的播客和集數信息。
• 自然語言處理：能處理自然語言查詢以找到相關內容。
• 元數據與URL獲取：可獲取音頻內容元數據和流媒體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  # 在Windows上：venv\Scripts\activate
   

3. 安裝依賴項：

   pip install -r requirements.txt
   

4. 創建一個.env文件並添加你的Radio France 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界面，其中你可以單獨測試服務器的每個工具。

📚 詳細文檔

有關更多詳細信息，請參閱：

• 使用指南 - 詳細的服務器使用說明
• API 信息 - 關於Radio France API的詳細信息

🔧 技術細節

Radio France API 使用基於分類的方法：

1. 分類：類別、標籤和主題，用於組織內容
2. Diffusions：與分類相關聯的內容項（集數、節目）
3. 品牌：播客和系列節目
4. 網格：電視頻道的時間表

📄 許可證

本項目採用 MIT 許可證。

示例查詢（適用於Claude）

以下是你可以詢問Claude的一些示例查詢：

1. “給我找關於法國曆史的播客”
2. “France Inter上現在正在播放什麼？”
3. “搜索有關歐洲政治的集數”
4. “Radio France上的不同播客類別有哪些？”
5. “獲取這個URL處音頻內容的信息”

貢獻

歡迎貢獻！請隨時提交拉取請求。