Radio France Podcast Explorer MCP

Radio France 播客探索 MCP

一个模型上下文协议（MCP）服务，可让 Claude 等 AI 助手搜索和探索 Radio France 的播客、音频回放及其他内容。

功能

• 按主题搜索播客和单集
• 获取 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. 创建一个 .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

这将打开一个网页界面，你可以在其中逐一测试服务的各项工具。

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 对应的音频内容信息。”

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT