mcp服务器云代理
MCP服务器 云代理 --托管的人工智能软件工程师,负责编写代码、打开PR、审查代码、生成测试、运行安全扫描和回答代码库问题。
从任何MCP客户端(Claude Code、Cursor、Windsurf或您自己的代理)连接并委派工程任务。
运作原理
这个包裹是 本地stdio MCP代理 将请求转发到Cloud Agent托管的后端 agent.leddconsulting.com。您的MCP客户端通过stdio与此服务器通信;服务器代表您对后端进行经过身份验证的HTTPS调用。
遗产 cloudagent.metaltorque.dev URL仍然会重定向,但新的配置应该使用 agent.leddconsulting.com.
数据流: MCP客户端→ (stdio)→ 此服务器→ (HTTPS)→ 云代理后端→ GitHub
哪些数据会离开您的机器:
- 您提供的任务描述、仓库名称、文件路径和PR URL
- 您的API密钥(仅通过HTTPS发送,从不通过HTTP发送)
后端如何处理您的数据:
- 使用自己的GitHub应用程序凭据从GitHub克隆存储库
- 在隔离的沙盒中执行任务
- 代表您打开PR并将评论发布到GitHub
工具(9)
| 工具 | 描述 | 副作用 |
|---|---|---|
run_task | 编写代码、修复错误、添加功能——返回结果+PR URL | 创建分支和PR |
review_pr | 使用结构化反馈查看GitHub PR | 可选择在GitHub上发布评论 |
ask_codebase | 询问有关任何GitHub仓库的问题(首次使用时自动索引) | 只读 |
generate_tests | 为文件生成测试,打开PR | 创建分支和PR |
security_scan | 跨一个或多个存储库的安全性+依赖性扫描 | 只读 |
list_sessions | 列出最近的会话,包括状态、成本、持续时间、PR URL | 只读 |
list_playbooks | 列出可用的工作流模板 | 只读 |
run_playbook | 针对回购运行剧本 | 创建分支和PR |
get_usage | 使用统计数据——会话、成本、节省的时间、细分 | 只读 |
设置
1.获取API密钥
登录到您的Cloud Agent工作区 agent.leddconsulting.com 并在生成API密钥 /auth/api-key.密钥使用 ca_* 前缀。
2.配置您的MCP客户端
克劳德代码 (~/.claude.json):
{
"mcpServers": {
"cloud-agent": {
"command": "npx",
"args": ["-y", "mcp-server-cloud-agent"],
"env": {
"CLOUD_AGENT_API_KEY": "ca_your_key_here"
}
}
}
}光标/风帆 (MCP设置):
{
"mcpServers": {
"cloud-agent": {
"command": "npx",
"args": ["-y", "mcp-server-cloud-agent"],
"env": {
"CLOUD_AGENT_API_KEY": "ca_your_key_here"
}
}
}
}环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
CLOUD_AGENT_API_KEY | 是 | API密钥(ca_* 前缀)从您的Cloud Agent工作区 |
CLOUD_AGENT_URL | 否 | 后端URL(默认为 https://agent.leddconsulting.com) |
使用示例
配置后,您的MCP客户端可以直接调用这些工具:
修复一个bug:
“在myorg/myapp上使用云代理run_task修复中断的登录流”
审查PR:
“使用云代理review_pr onhttps://github.com/myorg/myapp/pull/42"
询问代码:
“在myorg/myapp上使用云代理ask_codebase:身份验证是如何工作的?”
生成测试:
“在myorg/myapp上为src/auth.ts使用云代理generate_tests”
安全扫描:
“在myorg/myapp和myorg/api上使用云代理security_scan”
示例输出
run_task响应:
{
"response": "Fixed the login redirect bug. Changed src/auth.ts to properly handle OAuth callback URLs.",
"cost_usd": 0.42,
"duration_ms": 45000,
"pr_url": "https://github.com/myorg/myapp/pull/87"
}security_scan响应:
{
"repos_scanned": 1,
"vulnerabilities": 3,
"secrets_found": 0,
"findings": [...]
}故障排除
| 问题 | 解决方案 |
|---|---|
| “CLOUD_AGENT_API_KEY是必需的” | 在MCP客户端配置中设置env var |
| “拒绝通过不安全的HTTP发送API密钥” | 使用HTTPS(默认)。不要设置 CLOUD_AGENT_URL 到HTTP URL |
| “请求超时” | 任务最多需要10分钟。检查 list_sessions 对于状态 |
| “HTTP 401” | 您的API密钥无效或已过期。生成一个新的 |
| “HTTP 429” | 速率受限。等待并重试 |
许可证
麻省理工学院
