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

贡献

欢迎贡献！请随时提交拉取请求。