播客索引MCP服务器
模型上下文协议(MCP)服务器 播客索引.org API搜索播客、发现热门节目、查找剧集、探索Value4Value货币化等等。
______________________________________________________________________
🚧 开发部门:MCP应用程序支持
此分支扩展了PodcastIndex MCP服务器以支持 MCP应用程序 --MCP生态系统的新特征。
视觉
探索如何将播客发现和互动作为完整的MCP应用程序体验来提供,而不仅仅是工具/服务器集成。该项目旨在成为MCP Apps的早期推动者,并为生态系统中的其他构建者展示模式。
目标
- 基于现有的播客索引MCP服务器代码库构建
- 实施MCP Apps支持,实现丰富的播客发现用户体验
- 将交互式播客浏览、搜索和播放控制作为应用程序体验启用
- 作为MCP Apps模式的参考实现
开发工具
此分支使用以下方式构建和管理:
______________________________________________________________________
特性
- 25+MCP工具 涵盖所有主要的PodcastIndex API端点
- 搜索 -按术语、标题或人(主持人/嘉宾)查找播客
- 播客 -通过订阅源ID、URL、iTunes ID、GUID获取详细信息,或浏览趋势/死订阅源
- 剧集 -按订阅源、剧集ID、GUID获取,或发现直播/随机剧集
- 最近 -获取最近更新的剧集、订阅源和新订阅源
- 价值4价值 -探索播客盈利信息(无需身份验证)
- 统计数据和类别 -当前指数统计和类别列表
- 中心通知 -PubSubHubbub通知
快速开始
获取API凭据(免费)
- 访问 https://api.podcastindex.org/
- 创建免费帐户
- 生成您的API密钥和秘密
为Claude Desktop安装
添加到您的Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"podcastindex": {
"command": "npx",
"args": ["-y", "github:cclawton/podcastindex-mcp-server"],
"env": {
"PODCASTINDEX_API_KEY": "your-api-key-here",
"PODCASTINDEX_API_SECRET": "your-api-secret-here"
}
}
}
}这直接从GitHub安装-不需要npm注册表。
添加配置后重新启动Claude Desktop。
从源代码安装
# Clone the repository
git clone https://github.com/cclawton/podcastindex-mcp-server.git
cd podcastindex-mcp-server
# Install dependencies
npm install
# Build
npm run build
# Set environment variables
export PODCASTINDEX_API_KEY="your-api-key"
export PODCASTINDEX_API_SECRET="your-api-secret"
# Run
npm start对于本地安装的Claude Desktop:
{
"mcpServers": {
"podcastindex": {
"command": "node",
"args": ["/path/to/podcastindex-mcp-server/dist/index.js"],
"env": {
"PODCASTINDEX_API_KEY": "your-api-key-here",
"PODCASTINDEX_API_SECRET": "your-api-secret-here"
}
}
}
}可用工具
搜索工具
| 工具 | 说明 |
|---|---|
podcast_search_byterm | 在标题、作者、所有者和描述中搜索播客 |
podcast_search_bytitle | 仅按标题搜索播客 |
podcast_search_byperson | 查找以特定人物为特色的剧集 |
podcast_search_music | 搜索音乐播客 |
播客工具
| 工具 | 说明 |
|---|---|
podcast_get_byfeedid | 通过播客索引订阅源ID获取播客 |
podcast_get_byfeedurl | 通过订阅源URL获取播客 |
podcast_get_byitunesid | 通过iTunes/Apple播客ID获取播客 |
podcast_get_byguid | 按GUID获取播客 |
podcast_get_trending | 获取热门播客(按语言/类别筛选) |
podcast_get_dead | 获取已死亡/不活动播客提要列表 |
剧集工具
| 工具 | 说明 |
|---|---|
episodes_get_byfeedid | 按播客订阅源ID获取剧集 |
episodes_get_byfeedurl | 通过播客订阅源URL获取剧集 |
episodes_get_byid | 按ID获取单集 |
episodes_get_byguid | 按GUID获取剧集 |
episodes_get_live | 获取当前直播剧集 |
episodes_get_random | 获取随机剧集 |
最近使用的内容工具
| 工具 | 说明 |
|---|---|
recent_episodes | 获取最近更新的剧集 |
recent_feeds | 获取最近更新的播客提要 |
recent_newfeeds | 获取新添加的播客提要 |
Value4Value工具(无需授权)
| 工具 | 说明 |
|---|---|
value_get_byfeedid | 通过订阅源ID获取Value4Value信息 |
value_get_byfeedurl | 通过订阅源URL获取Value4Value信息 |
value_get_bypodcastguid | 通过播客GUID获取Value4Value信息 |
统计数据和类别
| 工具 | 说明 |
|---|---|
stats_current | 获取当前播客索引统计信息 |
categories_list | 列出所有播客类别 |
中心通知(无需授权)
| 工具 | 说明 |
|---|---|
hub_pubnotify | 发送PubSubHubbub通知 |
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
PODCASTINDEX_API_KEY | 是\* | 您的PodcastIndex API密钥 |
PODCASTINDEX_API_SECRET | 是\* | 您的播客索引API秘密 |
PODCASTINDEX_USER_AGENT | 否 | 自定义用户代理(默认:“播客索引MCPServer/1.0.0”) |
\*经过身份验证的端点需要。Value4Value和Hub工具无需凭据即可工作。
Claude中的示例用法
配置后,您可以向Claude询问以下问题:
- “搜索有关人工智能和机器学习的播客”
- “现在流行的播客是什么?”
- “查找乔·罗根主演的剧集”
- “获取播客ID 920666的Value4Value信息”
- “显示最近更新的播客提要”
- “可用的播客类别有哪些?”
发展
# Install dependencies
npm install
# Build TypeScript
npm run build
# Watch mode for development
npm run dev
# Clean build artifacts
npm run clean需求
- Node.js 18.0.0或更高版本
- npm 9.0.0或更高版本
许可证
麻省理工学院
