@microservices-sh/mcp

@microservices-sh/mcp

Local stdio MCP server for microservices.sh modules, templates, checks, and guarded preview deployment.

This package is a standalone stdio MCP server. It vendors a small microservices.sh SDK/module-contract snapshot until the public SDK is split out.

Install

pnpm add -D @microservices-sh/mcp

Or run it directly after publish:

pnpm dlx @microservices-sh/mcp

MCP Client Config

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

For local development inside this repo:

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

Build the local package first:

pnpm build

Tools

Read-only and local planning tools:

• 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

Remote control-plane tools:

• deploy_preview
• get_deployment_status

deploy_preview is mutating and requires confirm: "preview". Run create_preview_plan first.

Environment

Variable	Purpose
MICROSERVICES_API_URL	Remote control-plane URL. Defaults to http://127.0.0.1:8787.
MICROSERVICES_API_KEY	Bearer token for remote tools.
MICROSERVICES_TOKEN	Fallback bearer token.

Secret values are never returned by the MCP tools.

Registry Notes

The package declares:

{
  "mcpName": "sh.microservices/mcp"
}

Before publishing to the official MCP Registry, verify the microservices.sh DNS namespace and publish the npm package. Docker/OCI packaging should wrap this same stdio server rather than forking behavior.