关于 Depot MCP by usefulapi
Depot MCP by usefulapi 是托管式 MCP 服务,用于检查 Depot 构建、CI 活动和 GitHub Actions 运行器用量。适合希望通过 MCP 客户端查看构建详情与日志,或操作 CI 运行的 Depot 团队。
主要功能
- 01查看项目、构建和构建步骤
- 02读取构建与 CI 任务日志
- 03检查 CI 运行并诊断故障
- 04查看 GitHub Actions 运行器用量与分析
- 05重试或取消 CI 工作
- 06管理项目与缓存条目
适用场景
- 01根据构建步骤和日志排查失败
- 02查看 CI 运行状态并诊断故障
- 03重试失败任务或取消 CI 运行
- 04检查 GitHub Actions 运行器用量
MCP 相关
通过托管端点向 MCP 客户端提供 Depot 构建、CI、缓存和运行器工具。用户使用 Depot 组织 API 令牌连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://depot.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-depot https://depot.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-depot":{"type":"http","url":"https://depot.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-depot":{"type":"http","url":"https://depot.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-depot":{"type":"http","url":"https://depot.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-depot":{"serverUrl":"https://depot.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
22| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page_size | integer | 否 | 分页大小,1-250。 |
| region_id | string | 否 | 仅包含此区域或云连接中的项目,例如 us-east-1。 |
| page_token | string | 否 | 上一响应中的 nextPageToken 游标。第一页时省略。 |
详细介绍
usefulapi 的 Depot MCP
通过 Claude、Cursor 或任何 MCP 客户端使用 Depot——检查项目、容器构建、构建步骤和日志、Depot CI 运行和作业,以及 GitHub Actions 运行器用量,还可重试或取消 CI 工作。 托管式服务,无需本地安装:使用你自己的 Depot 凭据连接。
实时端点: https://depot.usefulapi.io/mcp · 主页: https://usefulapi.io/depot
连接
- Claude(claude.ai、桌面版):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://depot.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http depot https://depot.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将该 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"depot": {
"url": "https://depot.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Depot 凭据。
分步设置说明、凭据查找方式和常见问题解答:https://usefulapi.io/depot/
首次连接时,你需要提供Depot 组织 API 令牌(Organization Settings → API Tokens)。 系统会验证令牌、按用户存储并限定为你本人使用——配置文件中不会包含密钥。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
depot_list_projects | read | 列出项目 |
depot_get_project | read | 获取项目 |
depot_list_builds | read | 列出项目的构建 |
depot_get_build | read | 获取构建 |
depot_get_build_steps | read | 列出构建的步骤 |
depot_get_build_step_logs | read | 获取构建步骤的日志 |
depot_list_registry_images | read | 列出注册表镜像 |
depot_get_usage | read | 获取组织用量 |
depot_ci_list_runs | read | 列出 Depot CI 运行 |
depot_ci_get_run_status | read | 获取 CI 运行的状态树 |
depot_ci_list_workflows | read | 列出 Depot CI 工作流 |
depot_ci_get_job | read | 获取 CI 作业 |
depot_ci_get_job_logs | read | 获取 CI 作业的日志 |
depot_ci_get_failure_diagnosis | read | 诊断 CI 故障 |
depot_gha_list_jobs | read | 列出在 Depot 运行器上运行的 GitHub Actions 作业 |
depot_gha_search_logs | read | 搜索 GitHub Actions 日志 |
depot_gha_get_analytics | read | 获取 GitHub Actions 分析数据 |
depot_gha_list_recommendations | read | 列出运行器规格建议 |
depot_cache_list_entries | read | 列出缓存条目 |
depot_cache_delete_entries | write | 删除缓存条目 |
depot_create_project | write | 创建项目 |
depot_ci_retry_job | write | 重试 CI 作业 |
depot_ci_retry_failed_jobs | write | 重试工作流中失败的作业 |
depot_ci_cancel_run | write | 取消 CI 运行 |
depot_usage_status | meta | 用量状态(免费套餐计量) |
depot_request_feature | meta | 请求添加缺失的功能 |
depot_upgrade | meta | 升级到 Pro(无限制*) |
depot_cancel_subscription | meta | 取消 Pro 订阅 |
read 工具为只读;write 工具会修改数据(客户端应在使用前确认);meta 工具用于报告用量、管理订阅或发送功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| 免费版 | $0 | 每月 50 次工具调用 |
| Pro(按用户计费) | $9/mo 或 $90/yr(免费使用 2 个月) | 无限* |
*此服务上的 Pro 套餐设有每月 10,000 次工具调用的合理使用限额。超出限额请发送邮件至 [email protected]。
Pro 套餐仅适用于此服务。使用 depot_upgrade 订阅(它会返回 Stripe Checkout 链接)。可随时使用 depot_cancel_subscription 取消:Pro 权益会持续到付费周期结束,当前周期不予退款;在此之前运行 depot_upgrade 可撤销取消操作。或者发送邮件至 [email protected]。
许可证
MIT © usefulapi。与 Depot 无关联,亦未获其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。