使用说明
播客索引MCP服务器
用于PodcastIndex API的MCP服务器。为AI代理提供播客搜索、发现、剧集查找、趋势提要和Value4Value货币化数据的原生访问权限，因此代理可以像访问任何其他工具一样研究、引用和推理播客。专为与Claude、Claude Code和任何MCP感知代理配合使用而构建。
特性
- 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或更高版本
连接堆栈的一部分
- 主管 --代理系统架构
- 牛棚 --内容管道（播客研究用例）
- 六种经文合璧 --人工智能评估
- github/cclawton --个人资料
许可证
麻省理工学院