Advertise
MCP.so
Sign In

MCP Compose

@phildougherty

Repository

Basic information

Category

Other

License

AGPL-3.0

Transports

stdio

Author

phildougherty

About MCP Compose

Compose, manage, and run MCP servers as Docker containers. With a Unified API gateway built in.

MCP Compose config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-compose": {
      "command": "docker",
      "args": [
        "ps",
        "-a",
        "#",
        "Check",
        "container",
        "status"
      ]
    }
  }
}

MCP Compose tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP-Compose?

MCP-Compose is a Docker Compose‑style orchestration tool for Model Context Protocol (MCP) servers. It runs multiple MCP servers with a unified YAML configuration, an HTTP proxy that automatically translates STDIO to HTTP, and full container orchestration. It is built for developers and operators who manage several MCP servers together.

How to use MCP-Compose?

Install by cloning the repository and running make build, then add the binary to your PATH. Create a mcp-compose.yaml configuration file (or run mcp-compose init for an interactive wizard). Start all servers with mcp-compose up, start the HTTP proxy with mcp-compose proxy --port 9876, and access the web dashboard with mcp-compose dashboard. Use mcp-compose create-config --type claude to generate client configuration for Claude Desktop.

Key features of MCP-Compose

  • Docker Compose‑style YAML configuration
  • HTTP proxy with automatic protocol translation (STDIO → HTTP)
  • Native support for Docker and Podman
  • Session management and connection pooling
  • Built‑in dashboard and monitoring
  • OpenAPI spec generation

Use cases of MCP-Compose

  • Run multiple MCP servers with a single command
  • Provide a unified HTTP API for STDIO‑based MCP servers
  • Manage development MCP environments with container orchestration
  • Securely expose MCP servers with proxy authentication

Frequently asked questions

1

What are the system requirements?

Docker 20.10+ or Podman 3.0+, Linux, macOS, or Windows with WSL2, and Go 1.19+ if building from source.

2

How do I authenticate the HTTP proxy?

Set `proxy_auth.enabled: true` and `proxy_auth.api_key: "${MCP_API_KEY}"` in your config file, then export the key in your shell. Alternatively, start the proxy with `mcp-compose proxy --api-key $(openssl rand -hex 32)`.

3

How can I view logs or check service status?

Use `mcp-compose ps` to list service status, `mcp-compose system status` for a health overview, and `mcp-compose logs <service>` to view specific logs.

4

How do I integrate with Claude Desktop?

Run `mcp-compose create-config --type claude --output ./claude-config` and copy the generated configuration into Claude Desktop’s settings.

5

Can I start or stop only specific servers?

Yes. Use `mcp-compose up <service>` to start a single service and `mcp-compose down <service>` to stop it.

Comments

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Advertise