microservices.sh

@microservices-sh/mcp

再利用可能な microservices.sh モジュールを使用して、Cloudflare ネイティブアプリを生成、検証、デプロイする AI エージェント向けの MCP サーバーです。

このパッケージは、単独で動作する stdio MCP サーバーです。公開 SDK が切り出されるまで、小規模な microservices.sh SDK／モジュールコントラクトのスナップショットを同梱しています。

エージェントに選ばれる理由

@microservices-sh/mcp は、コーディングエージェントに、本番運用を意識した Cloudflare アプリを構築するための型付き計画レイヤーを提供します。エージェントは、検証済みテンプレートやモジュールの検索、モジュールコントラクトの確認、アプリ計画の作成、設定の検証、レビュー用プロジェクトファイルの生成、準備状況のチェックの実行、microservices.sh コントロールプレーンを介した承認必須のプレビューデプロイの準備を行えます。

認証、予約、顧客記録、決済、ファイル、監査ログなどの一般的な製品モジュールを使ってアプリを構築する際、エージェントが各連携を一から作る必要がないため便利です。

インストール

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

エージェント向けのワンクリックインストール手順については、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	リモートツール用のベアラートークンです。
MICROSERVICES_TOKEN	フォールバック用のベアラートークンです。

シークレットの値が 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 サーバーをラップする必要があります。