Radio France Podcast Explorer MCP

一个模型控制协议 (MCP) 服务器，允许像 Claude 这样的人工智能助手搜索和探索来自法国广播电台的播客、音频重播和其他内容。

功能

• 按主题搜索播客和剧集
• 获取特定法国广播电台的节目信息
• 探索按分类法（主题、类别、标签）组织的内容
• 检索详细的播客和剧集信息
• 处理自然语言查询以查找相关内容
• 获取音频内容元数据和流 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. 创建一个包含您的法国广播电台 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 结构

法国广播电台 API 使用基于分类法的方法：

1. 分类法: 组织内容的主题、类别和标签
2. Diffusions: 与分类法相关联的内容项（剧集、节目）
3. Brands: 节目和播客系列
4. Grid: 电台的节目时间表

文档

有关更多详细信息，请参阅：

• 使用指南 - 关于使用服务器的详细说明
• API 信息 - 关于法国广播电台 API 的信息

Claude 的示例查询

以下是一些您在使用此 MCP 服务器时可以向 Claude 提出的示例查询：

1. "Find me podcasts about French history" (查找关于法国历史的播客)
2. "What's currently playing on France Inter?" (法国国际广播电台现在正在播放什么？)
3. "Search for podcast episodes about European politics" (搜索关于欧洲政治的播客剧集)
4. "What are the different podcast categories on Radio France?" (法国广播电台有哪些不同的播客类别？)
5. "Get me information about the audio content at this URL" (获取此 URL 上的音频内容的信息)

贡献

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

许可证

MIT