Radio France Podcast Explorer MCP
About
A Model Control Protocol (MCP) server for exploring and accessing Radio France podcasts and audio content.
Details
- Author
- infinitimeless
- Downloads
- 198
- Categories
- Other
Jump to
- Search for podcasts and episodes by topic
- Get program information for specific Radio France stations
- Explore content organized by taxonomies (themes, categories, tags)
- Retrieve detailed podcast and episode information
- Process natural language queries to find relevant content
- Get audio content metadata and stream URLs
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Radio France Podcast Explorer MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install dependencies (Python 3.7+), create a .env file with your Radio France API key, then run python server.py. To use with Claude Desktop, add the server configuration to claude_desktop_config.json with the command python and the absolute path to server.py, along with the RADIOFRANCE_API_KEY environment variable.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"radio france podcast explorer mcp": {
"radiofrance-podcast-explorer-mcp": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}
}
}McpServers
{
"radiofrance-podcast-explorer-mcp": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}Radio France Podcast Explorer MCP
A Model Control Protocol (MCP) server that allows AI assistants like Claude to search for and explore podcasts, audio replays, and other content from Radio France.
Features
- Search for podcasts and episodes by topic
- Get program information for specific Radio France stations
- Explore content organized by taxonomies (themes, categories, tags)
- Retrieve detailed podcast and episode information
- Process natural language queries to find relevant content
- Get audio content metadata and stream URLs
Requirements
- Python 3.7+
- Radio France API Key (obtain from Radio France Open API)
Installation
1. Clone this repository:
git clone https://github.com/infinitimeless/radiofrance-podcast-explorer-mcp.git
cd radiofrance-podcast-explorer-mcp
2. Create a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
3. Install dependencies:
pip install -r requirements.txt
4. Create a .env file with your Radio France API key:
RADIOFRANCE_API_KEY=your_api_key_here
Testing
Before running the server, you can verify your installation and API key by running the tests:
python run_tests.py
You can also run the GraphQL schema test to verify API structure:
python tests/test_schema.py
Running the Server
python server.py
Using with Claude Desktop
To use this server with Claude Desktop:
1. Open the file at the following location:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Add or update the server configuration:
{
"mcpServers": {
"radiofrance": {
"command": "python",
"args": ["/absolute/path/to/radiofrance-podcast-explorer-mcp/server.py"],
"env": {
"RADIOFRANCE_API_KEY": "your_api_key_here"
}
}
}
}
3. Save the file and restart Claude Desktop
Development Testing
You can test the server using the MCP Inspector:
npx @modelcontextprotocol/inspector python server.py
This will open a web interface where you can test each of the server's tools individually.
API Structure
The Radio France API uses a taxonomy-based approach:
1. Taxonomies: Categories, tags, and themes that organize content
2. Diffusions: Content items (episodes, programs) associated with taxonomies
3. Brands: Shows and podcast series
4. Grid: Program schedules for stations
Documentation
For more detailed information, see:
- Usage Guide - Detailed instructions on using the server
- API Information - Information about the Radio France API
Example Queries for Claude
Here are some example queries you can ask Claude when using this MCP server:
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"
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
