MCP-Compose

by phildougherty

56 stars
282 downloads
Not rated
GitHub

About

Orchestration tool for managing multiple MCP servers with a Docker Compose-style interface and a unified HTTP proxy.

Details

Author
phildougherty
GitHub stars
56
Downloads
282
Categories
Developer Tools, Other, Infrastructure, Automation, API

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP-Compose
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

MCP-Compose

codecov
Go Report Card
License: AGPL v3
Release

Docker Compose for Model Context Protocol servers. Run multiple MCP servers with unified configuration, HTTP proxy, and container orchestration.

MCP-Compose Demo

Features

- 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

Installation

```bash
git clone https://github.com/phildougherty/mcp-compose.git
cd mcp-compose
make build

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.