用途
podcastindex-mcp 是一个 MCP(Model Context Protocol)服务器,用于将 Claude 连接到 Podcast Index API。它的目标是让 Claude 能够搜索播客、追踪嘉宾出场、监控热门节目以及检查 feed 健康状态。该项目由 Conor Bronsdon 构建并维护,用于 Chain of Thought 播客的制作工作流,在该流程中用于呈现嘉宾出场并检查 feed 健康状态。
主要能力
根据官方说明,该服务器提供以下能力:
- 搜索播客
- 追踪嘉宾出场(by person)
- 监控热门节目(trending shows)
- 检查 feed 健康状态(feed health)
示例提问包括:
- “Search Podcast Index for all episodes featuring Satya Nadella as a guest”
- “What are the trending technology podcasts right now?”
- “Look up the feed health for https://feeds.transistor.fm/chain-of-thought and list the last 5 episodes”
该服务器完全只读:每个工具都声明了 MCP 工具注解 readOnlyHint: true,因此客户端知道没有任何调用会修改内容,可以跳过写入确认提示。
使用方式
- 获取免费 Podcast Index API 凭据:在 api.podcastindex.org 获取。
- 将服务器添加到 Claude Desktop 配置(claude_desktop_config.json)。
- 或添加到项目的 .mcp.json。
构建项目:
npm run build
开发期间监听变化:
npm run dev
添加新工具的步骤:
- 在 src/api-client.ts 中添加 API 方法
- 在 src/types.ts 中添加类型守卫和参数类型
- 在 src/tool-handlers.ts 中添加工具定义和处理程序
- 使用 npm run build 重新构建
错误处理:API 失败会映射到带类型的错误层级(src/errors.ts 中),基类为 PodcastIndexError,包含 AuthenticationError、RateLimitError、ValidationError、NotFoundError 和 ServerError 子类,根据 HTTP 状态码区分。每次工具调用失败时仍返回相同的 isError: true 响应结构,带类型的层级只是让消息具体化(凭据错误、限流、请求格式错误等),而不是单一的通用“API error”字符串。
适用场景
- 播客制作工作流中查找嘉宾出场
- 研究阶段检查 feed 健康状态
- 查询热门播客节目
- 与配套工具协同使用,例如 Transistor MCP(Transistor.fm 官方 MCP 服务器,用于单集、发布和分析)、substack-mcp(阅读帖子和管理 Substack 草稿)、op3-mcp(报告下载量、听众地域和应用)、apple-podcasts-mcp(从 Apple Podcasts Connect 拉取播放量、关注者和单集收听数据)、gsc-mcp(查询 Google Search Console 中的搜索表现、关键词和站点地图)、podcast-benchmark(仅使用公开数据将节目与同类节目对标)。
限制
- 需要自行获取 Podcast Index API 凭据,凭据获取地址为 api.podcastindex.org。
- 服务器为只读,不提供写入或修改功能。
- 依赖 Podcast Index API,所有工具都是该 API 的薄封装。
- 这是独立的个人项目,不隶属于、不受赞助或背书于任何公司。
- 官方说明中展示的演示结果为示例数据,并非真实的 Podcast Index 响应。
- 关于收费、价格、具体平台支持范围等信息,资料中暂未提供。