microservices.sh

@microservices-sh/mcp

面向 AI Agent 的 MCP 服务，可基于可复用的 microservices.sh 模块生成、验证并部署 Cloudflare 原生应用。

此软件包是一个独立的 stdio MCP 服务。在公共 SDK 拆分出来之前，它会内置一份精简的 microservices.sh SDK/模块契约快照。

Agent 为何使用它

@microservices-sh/mcp 为编码 Agent 提供类型化的规划层，用于构建面向生产环境的 Cloudflare 应用。Agent 可以发现经过验证的模板和模块、检查模块契约、组合应用计划、验证配置、生成供审阅的项目文件、运行就绪检查，并通过 microservices.sh 控制平面准备需要审批的预览部署。

当 Agent 需要构建包含身份验证、预订、客户记录、支付、文件和审计日志等常见产品模块的应用，而不想从头设计每项集成时，这个工具就很有用。

安装

pnpm add -D @microservices-sh/mcp

也可以在发布后直接运行：

pnpm dlx @microservices-sh/mcp

或从 Glama 安装：

• Glama 上的 @microservices-sh/mcp

MCP 客户端配置

{
  "mcpServers": {
    "microservices": {
      "command": "microservices-mcp",
      "env": {
        "MICROSERVICES_API_URL": "https://api.microservices.sh",
        "MICROSERVICES_API_KEY": "favored-secret-manager-reference"
      }
    }
  }
}

在此仓库中进行本地开发：

{
  "mcpServers": {
    "microservices-local": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/dist/index.js"]
    }
  }
}

先构建本地软件包：

pnpm build

有关面向 Agent 的一键安装指南，请参阅 llms-install.md。

工具

只读和本地规划工具：

• list_templates
• inspect_template
• list_modules
• inspect_module
• list_module_docs
• get_module_doc
• compose_app
• validate_config
• generate_project
• run_checks
• plan_add_module
• check_updates
• plan_module_upgrade
• get_secrets_status
• create_preview_plan

远程控制平面工具：

• deploy_preview
• get_deployment_status

deploy_preview 会修改数据，并且需要 confirm: "preview"。请先运行 create_preview_plan。

环境变量

变量	用途
MICROSERVICES_API_URL	远程控制平面 URL。默认为 https://api.microservices.sh。
MICROSERVICES_API_KEY	远程工具的 Bearer 令牌。
MICROSERVICES_TOKEN	后备 Bearer 令牌。

MCP 工具绝不会返回密钥值。

注册信息

此软件包已发布到 npm、列入官方 MCP Registry，并通过 Glama 验证：

• npm：@microservices-sh/mcp
• MCP Registry：sh.microservices/mcp
• Glama：@microservices-sh/mcp
• awesome-mcp-servers：PR #8249
• 远程端点：https://api.microservices.sh/mcp

软件包在 package.json 中声明了 "mcpName": "sh.microservices/mcp"。Docker/OCI 打包应封装同一个 stdio 服务，而不是派生出不同的行为。