内容
@microservices-sh/mcp
[](https://www.npmjs.com/package/@microservices-sh/mcp)
[](https://registry.modelcontextprotocol.io/v0.1/servers?search=sh.microservices/mcp)
[](https://glama.ai/mcp/servers/microservices-sh/mcp)
用于 AI 代理的 MCP 服务器，生成、验证和部署 Cloudflare 原生应用，基于可重用的 microservices.sh 模块。
此软件包是一个独立的 stdio MCP 服务器。它提供了一个小的 microservices.sh SDK/模块合约快照，直到公共 SDK 被分离出来。
## 为什么代理使用它
`@microservices-sh/mcp` 为构建面向生产的 Cloudflare 应用的编码代理提供了一个有类型的规划层。代理可以发现已验证的模板和模块，检查模块合约，组成应用计划，验证配置，生成项目文件以供审查，运行就绪检查，并通过 microservices.sh 控制平面准备审批门控预览部署。
当代理需要使用常见的产品模块（如身份验证、预订、客户记录、支付、文件和审计日志）构建应用时，它非常有用，而无需从头开始创建每个集成。
## 安装
```bash
pnpm add -D @microservices-sh/mcp
```
或直接在发布后运行：
```bash
pnpm dlx @microservices-sh/mcp
```
或从 Glama 安装：
- [`@microservices-sh/mcp` 在 Glama 上](https://glama.ai/mcp/servers/microservices-sh/mcp)
## MCP 客户端配置
```json
{
"mcpServers": "microservices": {
"command": "microservices-mcp",
"env": {
"MICROSERVICES_API_URL": "https://api.microservices.sh",
"MICROSERVICES_API_KEY": "favored-secret-manager-reference"
}
}
}
}
```
在本地仓库中开发：
```json
{
"mcpServers": {
"microservices-local": {
"command": "node",
"args": ["/absolute/path/to/mcp/dist/index.js"]
}
}
}
```
首先构建本地软件包：
```bash
pnpm build
```
有关代理导向的一键安装指南，请参阅 [`llms-install.md`](./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 | 备用 Bearer 令牌。 |
MCP 工具永远机密值。
## 注册
该软件包发布到列在官方 MCP 注册中心由 Glama 验证：
- npm：[`@microservicescp`](https://www.npmjs.com/package/@microservices-sh/mcp)
- MCP 注册中心：[`sh/mcp`](https://registryprotocol.io/v0.1?search=sh.microservices/mcp)
- Glama：[`@microservices-sh/mcp`](https://glama.ai/mcp/servers/microservices-sh/mcp)
- awesome-mcp-servers：[PR #8249](https://github.com/punkpeye/awesome-mcp-servers/pull/8249)
- 远程端点：`https://api.microservices.sh/mcp`
软件包在 `package.json` 中声明 `"mcpName": "sh.microservices/mcp"`。OCI 打包应包装此io 服务器，而不是分叉行为。
