Simplifyd Cloud

Simplifyd Cloud MCP 服务

适用于 Simplifyd Cloud 平台的 MCP（Model Context Protocol） 服务。

它为启用 MCP 的客户端提供用于管理 Simplifyd Cloud 资源的工具，可通过 stdio（本地客户端将二进制文件作为子进程启动）或 可流式 HTTP（托管式多用户部署）使用。同一个二进制文件支持这两种方式；由 MCP_TRANSPORT 选择。

工具

类别	工具
身份验证	login（仅限 stdio）、get-me
工作区	list-workspaces、get-workspace、create-workspace、update-workspace、get-workspace-usage、get-workspace-transactions、get-my-role、list-workspace-members、add-workspace-member、update-member-role、remove-workspace-member、fund-workspace、get-registry、list-registry-repos、list-registry-artifacts、delete-registry-tag
镜像仓库凭据	list-registry-credentials、add-registry-credential、update-registry-credential、remove-registry-credential — 工作区用于访问私有镜像仓库（ghcr.io、Docker Hub 等）的拉取凭据，按镜像仓库继承给其 Docker 镜像服务。服务自身的凭据通过 update-service 及其 registry_credentials / clear_registry_credentials 操作设置
项目	list-projects、get-project、create-project、update-project
环境	list-environments、get-environment、create-environment、update-environment、list-env-variables、create-env-variable、update-env-variable、delete-env-variable
服务	list-services、get-service、create-service、update-service、delete-service、list-private-service-access、grant-private-service-access、revoke-private-service-access、list-service-variables、add-service-variable、set-service-variables、delete-service-variable、add-service-ingress、delete-service-ingress、add-tcp-proxy、delete-tcp-proxy、set-ingress-source-ranges、add-service-config、update-service-config、delete-service-config、approve-service-changeset、discard-service-changeset、add-shared-variable
部署	list-deployments、get-deployment、deploy-service、redeploy-service、undeploy-service、get-deployment-logs
指标	get-service-metrics、get-environment-metrics — 最近 1h、6h 或 1d 的 CPU、内存和磁盘使用情况，以分配量的百分比表示，并提供扩缩容信号
令牌	list-tokens、create-token、delete-token
模板	list-templates、get-template、deploy-template、get-publishable-variables
电子邮件	list-email-domains、add-email-domain、verify-email-domain、remove-email-domain — 使用 create-service 并将类型设为 email 来创建服务本身
域名	search-domains、quote-domain、list-domains、get-domain、register-domain（仅限 stdio）、renew-domain（仅限 stdio）、update-domain。购买和续订只有在第二次确认调用时才会从钱包扣款；托管服务不提供这些工具，因为 Claude 和 ChatGPT 目录会拒绝使用会花钱的工具，而用户会改在控制台购买和续订。
DNS	list-dns-zones、add-dns-zone、check-dns-zone、delete-dns-zone、list-dns-records、add-dns-record、update-dns-record、delete-dns-record

每个工具都带有标题以及明确的 readOnlyHint、destructiveHint 和 openWorldHint 注释，客户端会用这些注释来决定调用前是否需要征求确认。 分类定义在 tools/annotations.go 中，并有测试确保新增工具时不会遗漏注释。

目录列表

server.json 描述了托管服务的信息，供 MCP Registry 使用。Lovable 等支持注册表的 客户端会浏览该注册表。每次发布时递增其 version，并使用 mcp-publisher publish 发布。

构建

go build -o cloud-mcp .

传输方式

变量	默认值	含义
MCP_TRANSPORT	stdio	stdio 或 http
MCP_ADDR	:8080	监听地址（仅限 http）
MCP_ALLOWED_ORIGINS	(无)	以逗号分隔的浏览器来源允许列表（仅限 http）
SIMPLIFYD_API_URL	https://api.cloud.simplifyd.com	API 基础 URL
OPENAI_APPS_CHALLENGE	(无)	来自 OpenAI 插件门户的域名验证令牌，通过 /.well-known/openai-apps-challenge 提供（仅限 http）

使用 HTTP 时，MCP 端点会在裸源站和 /mcp 上响应，并提供纯文本 /healthz 供探测。 会话采用无状态设计，因此副本无需粘性路由。

身份验证

身份验证按传输方式区分，两者互不混用：

• stdio — 单个本地用户。令牌来自 SIMPLIFYD_API_TOKEN 或 ~/.simplifyd/config.json，也可以通过 login 工具交互式设置。
• http — 多个调用方。每个请求都必须携带自己的 Authorization: Bearer <token>，该令牌仅用于此次调用。 不会持久化任何内容，也不会在调用方之间共享凭据；此外，不会注册 login， 因为它会将某个调用方的凭据写入服务器磁盘，并应用于所有其他调用方。

stdio

选项 1 — 环境变量（推荐用于 CI）：

export SIMPLIFYD_API_TOKEN="your-jwt-token"

选项 2 — 交互式登录： 使用 login 工具，通过电子邮件和密码进行身份验证。令牌会保存到 ~/.simplifyd/config.json，并在后续运行时自动重复使用。

Claude Code 配置

添加到 MCP 设置中（.claude/settings.json 或 ~/.claude/settings.json）：

{
  "mcpServers": {
    "simplifyd-cloud": {
      "command": "/path/to/cloud/mcp/cloud-mcp",
      "env": {
        "SIMPLIFYD_API_TOKEN": "your-jwt-token"
      }
    }
  }
}

或者，如果你希望交互式身份验证（省略 SIMPLIFYD_API_TOKEN 并先运行 login）：

{
  "mcpServers": {
    "simplifyd-cloud": {
      "command": "/path/to/cloud/mcp/cloud-mcp"
    }
  }
}

http

运行服务：

MCP_TRANSPORT=http MCP_ADDR=:8080 ./cloud-mcp

将客户端指向该服务，并在请求头中传入 API 令牌：

{
  "mcpServers": {
    "simplifyd-cloud": {
      "type": "http",
      "url": "https://mcp.simplifyd.com",
      "headers": {
        "Authorization": "Bearer your-jwt-token"
      }
    }
  }
}

使用 create-token 工具或在控制面板中创建令牌。

安全

除非 Origin 请求头中的来源已列入 MCP_ALLOWED_ORIGINS，否则携带该请求头的请求都会被拒绝。这可以阻止 DNS 重绑定攻击，否则用户浏览器中的网页可能会操控托管服务。非浏览器客户端不会发送 Origin，因此不受影响。

常规资源响应不会包含变量值、密码、连接 URL、凭据数据块和配置文件内容。描述中明确说明会公开凭据的工具会按设计返回敏感数据；请仅在需要时使用，并避免将其输出复制到日志或工单中。

部署日志会过滤常见的凭据模式，但应用可能会以意料之外的格式输出机密信息。分享日志输出前请先检查。