使用说明
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-mcp
Nixos模块
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。
许可证
麻省理工学院
