Podhome MCP服务器
用于Podhome集成API的Babashka可流式HTTP MCP服务器。
快速开始
# Run (OS-assigned port)
PODHOME_API_KEY=your-key bb podhome_mcp.clj
# Or use bb.edn tasks
bb start # Start on port 9999
bb test # Run tests
bb health # Health check配置
通过环境变量设置：
export PODHOME_API_KEY="your-key"或者通过配置文件 ~/.config/podhome/config.edn:
{:api-key "your-key"}覆盖API基础URL:
export PODHOME_API_BASE="https://serve.podhome.fm"覆盖主机/端口：
export PODHOME_MCP_HOST="0.0.0.0"
export PODHOME_MCP_PORT="3003"可用工具（20）
| 工具 | 状态 | 描述 |
|---|---|---|
get-show | ✅ | 获取节目元数据 |
list-episodes | ✅ | 列出剧集（分页，默认20个小字段， fields="full" 为所有人） |
get-episode | ✅ | 获取剧集详细信息（完整） |
create-episode | ✅ | 从URL创建剧集 |
modify-episode | ✅ | 更新剧集（元数据+备用附件） |
schedule-episode | ✅ | 计划/发布 |
delete-episode | ✅ | 删除剧集 |
begin-upload | ⚠️ | 开始文件上传（API错误-返回400，使用create-epicode和file_url） |
finalize-upload | ⚠️ | 完成上传（取决于开始上传） |
upload-and-create | ⚠️ | 上传+创建剧集（取决于开始上传） |
get-chapters | ✅ | 列出章节（分页） |
create-chapter | ✅ | 添加章节 |
modify-chapter | ✅ | 更新章节 |
delete-chapter | ✅ | 删除章节 |
list-clips | ✅ | 列出剪辑（分页） |
create-clip | ✅ | 添加剪辑 |
modify-clip | ✅ | 更新剪辑 |
delete-clip | ✅ | 删除剪辑 |
get-transcript | ✅ | 获取成绩单 |
get-analytics | ✅ | 获取分析 |
无
直接运行
nix run github:JupiterBroadcasting/podhome-mcpNixos模块
services.podhome-mcp = {
enable = true;
port = 3003;
host = "127.0.0.1";
apiKeyFile = "/run/secrets/podhome-api-key";
};开发程序外壳
nix develop测试
bb smoke # Quick smoke test (no API key needed)
PODHOME_API_KEY=your-key bb test # Integration tests (real API)测试调用真正的Podhome API-没有模拟。
已知问题
- 上传API错误：
/api/begin_upload返回带有错误的HTTP 400'object' does not contain a definition for 'UploadUrl'这是一个。NET PascalCase/snake_case服务器上的反序列化错误。使用create-episode和file_url作为一种变通方法。
- MCP端点身份验证： MCP服务器位于
serve.podhome.fm/api/mcp只接受OAuth，不接受X-API-KEY。此服务器直接使用REST API。
许可证
麻省理工学院