SuperAPI AI 工具集

temps-mcp-setup

部署与运维

查看项目

更新于 10-15 21:55

技能介绍

用途:将 Temps 实例配置为 MCP(Model Context Protocol)服务器,使 AI 助手可直接与 Temps 交互,例如列出和查看项目、部署等。MCP 由 temps 二进制自身提供(ADR-039,crates/temps-mcp-server),没有独立安装包;旧的 @temps-sdk/mcp npm 包已移除,不应再安装或指向它。

主要能力:MCP 端点调用与 REST API 相同的服务层。工具分为 7 组:deployments、infrastructure、networking、data、observability、notifications、platform,可通过向导或连接 URL 的 ?groups= 参数选择。目前仅 platform(list_projects、get_project)和 deployments(list_deployments,以及写工具 trigger_deployment / confirm_action)实现了真实工具,其余五组尚无工具注册;也暂未提供 create_project 工具,需先用 REST API 或 Web UI 创建项目。

使用方式:先由管理员一次性启用(默认关闭):bunx @temps-sdk/cli mcp enable;可用 bunx @temps-sdk/cli mcp status 查看状态,或 curl -s http://localhost:8080/mcp/tools 探测(404 表示未启用)。再为每个用户、每个客户端配置:bunx @temps-sdk/cli mcp add <client>,client 可为 claude-code、claude-desktop、codex、cursor、vscode、windsurf、zed。向导会探测 /mcp/tools、询问工具组与是否启用写工具(默认只读)、建议创建专用 API 密钥,并写入客户端配置;Claude Code/Codex 会调用其自身命令。配置后需重启客户端。其他子命令:mcp status、mcp remove <client>。

认证与限制:除 GET /mcp/tools 外,所有请求需 Authorization: Bearer <api-key>,权限与 REST API 一致;?groups= 与 ?write=1 只缩小范围,不授予额外权限。写工具采用“提议—确认”模式:返回 5 分钟有效的一次性 token,需再调用 confirm_action 才真正执行,且会写入审计日志。同一客户端添加第二个实例会覆盖原 temps 条目,需手动编辑配置;密钥按实例隔离,不可跨实例使用。