phildougherty/mcp-compose

Run MCP servers as Docker containers, with one gateway

Before you install: no copy-paste command · no license recorded · link reachable

First step: git clone https://github.com/phildougherty/mcp-compose.git

View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site

Install & config

Client config (built from the install command this repo gives)

{
  "mcpServers": {
    "phildougherty-mcp-compose": {
      "command": "npx",
      "args": ["args"]
    }
  }
}

Parsed from the README we fetched on 2026-11-04; we have not executed it.

command/args come from the install command the repository states. When it is ambiguous, the project README wins.

VS Code (.vscode/mcp.json - the key is servers)

{
  "servers": {
    "phildougherty-mcp-compose": {
      "command": "npx",
      "args": ["args"]
    }
  }
}

Same server, but VS Code keeps it under <code>servers</code>.

Claude Code (command line)

claude mcp add --transport stdio phildougherty-mcp-compose -- npx args

Claude Code does not read a config file; add the server with this command.

Key names differ by client: Clients & CLI

Source: collected from the abordage/awesome-mcp list · type: MCP server
Harvest history: first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 10 sources
Score: score 1,003 · 10 sources · mcp
Install: npx args

FAQ (answers come from our records)

How do I install it?

The repository provides this install command: npx args. It comes from the repository itself; we cannot guarantee it runs as-is in your client.

Who is it for?

We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.

Who maintains it?

first catalogued 2026-11-05；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.

# MCP-Compose

以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →

Docker Compose for Model Context Protocol servers. Run multiple MCP servers with unified configuration, HTTP proxy, and container orchestration.
## 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
# Add to PATH
sudo cp build/mcp-compose /usr/local/bin/
# OR
export PATH="$PWD/build:$PATH"
## Quick Start
### Interactive Setup
bash
mcp-compose init
Follow the prompts to create your configuration.
### Manual Setup
Create mcp-compose.yaml:
yaml
version: '1'
servers:
filesystem:
protocol: stdio
command: npx
args:
"-y"
"@modelcontextprotocol/server-filesystem"
"/tmp"
capabilities: [resources, tools]
Start servers:
bash
mcp-compose up
Start the HTTP proxy:
bash
mcp-compose proxy --port 9876
Test it:
bash
curl http://localhost:9876/api/servers
## Working Examples
### Basic - Filesystem + Memory
yaml
version: '1'
servers:
filesystem:
protocol: stdio
command: npx
args:
"-y"
"@modelcontextprotocol/server-filesystem"
"${HOME}"
capabilities: [resources, tools]
volumes:
"${HOME}:${HOME}:ro"
memory:
protocol: stdio
command: npx
args:
"-y"
"@modelcontextprotocol/server-memory"
capabilities: [resources, tools]
### With Web Search
Add Brave Search (requires API key from https://brave.com/search/api/):
yaml
brave-search:
protocol: stdio
command: npx
args:
"-y"
"@modelcontextprotocol/server-brave-search"
capabilities: [tools]
env:
BRAVEAPIKEY: "${BRAVEAPIKEY}"
bash
export BRAVEAPIKEY="your-api-key"
mcp-compose up
See examples/ for more configurations.
## Commands
### Service Management
bash
mcp-compose up # Start all services
mcp-compose up filesystem # Start specific service
mcp-compose down # Stop all services
mcp-compose down filesystem # Stop specific service
mcp-compose restart # Restart all services
mcp-compose ps # List service status
mcp-compose logs filesystem # View logs
### System Services
System services are infrastructure components (proxy, dashboard, task-scheduler, memory).
bash
mcp-compose system up # Start system services
mcp-compose system down # Stop system services
mcp-compose system ps # List system services
mcp-compose system status # Health overview
mcp-compose system logs proxy # View system logs
### Proxy
bash
mcp-compose proxy --port 9876 # Start proxy
mcp-compose proxy --api-key $(openssl rand -hex 32) # With authentication
### Dashboard
bash
mcp-compose dashboard # Start web dashboard
# Access at http://localhost:3111
### Configuration
bash
mcp-compose init # Interactive setup wizard
mcp-compose validate # Validate config file
mcp-compose create-config --type claude # Generate client config
## Configuration Reference
### Basic Structure
yaml
version: '1'
# Optional: proxy authentication
proxyauth:
enabled: true
apikey: "${MCPAPIKEY}"
servers:
my-server:
protocol: string # stdio, http, sse
command: string # Executable (e.g., npx, python, node)
args: [string] # Command arguments
capabilities: [string] # tools, resources, prompts, sampling
env: # Environment variables

Listed badge (optional)

Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.

[![Listed on Anclum](https://anclum.com/badge/listed.svg)](https://anclum.com/en/s/phildougherty-mcp-compose/)

Source: awesome · https://github.com/phildougherty/mcp-compose
Browse by field: MCP servers
Listed by: 10 independent sources
added: today

More like this

rohitg00/kubectl-mcp-serverMCP server awslabs/mcpMCP server WayStation-ai/mcpMCP server open-webui/open-webuiMCP server browsermcp/mcpMCP server

All 6,229 →

Filed under

MCP servers6,229 entries MCP server6,545 Curated list pick6,618

Every tag opens the full list for that filter. Counts are the live catalogue figures.

Browse all fields →

← Back to index