P
phildougherty/mcp-compose
Run MCP servers as Docker containers, with one gateway
在 GitHub 查看 ↗链接已于 2026-11-12 核查 · HTTP 200 · 打开的是厂商自己的官网
安装与配置
客户端配置(取自该仓库的安装命令)
{
"mcpServers": {
"phildougherty-mcp-compose": {
"command": "npx",
"args": ["args"]
}
}
}解析自我们于 2026-11-04 抓取的该仓库 README;我们未执行过。
command/args 来自仓库写明的安装命令;不确定时请以该项目 README 为准。
VS Code(.vscode/mcp.json —— 键名是 servers)
{
"servers": {
"phildougherty-mcp-compose": {
"command": "npx",
"args": ["args"]
}
}
}VS Code 顶层键是 <code>servers</code>,其余与上面那份相同。
Claude Code(命令行)
claude mcp add --transport stdio phildougherty-mcp-compose -- npx args
Claude Code 不收 JSON 文件,用这条命令直接加。
配置项的键名以你的客户端为准:客户端与 CLI
- 来源明细
- 收录自 abordage/awesome-mcp 榜单(我们从中收集的条目之一) · 条目类型:MCP 服务
- 收录与活跃
- 收录于 2026-11-05 · 最近见到 2026-11-14 · 共见到 10 次 · 被 10 个来源列出
- 评分构成
- 综合分 1,003 · 10 个来源 · mcp
- 安装
npx args
常见问题(答案都来自我们的记录)
怎么安装?
该仓库给出的安装命令是
npx args。我们的记录里它是仓库自己提供的;不保证在你的客户端上直接可用。它适合谁 / 用来做什么?
我们把它归在这些标签下: MCP 服务。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
我们收录于 2026-11-05;最近见到 2026-11-14。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。
# 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
## 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
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/phildougherty-mcp-compose/)
- 来源
- awesome · https://github.com/phildougherty/mcp-compose
- 按领域浏览
- MCP 服务
- 收录来源
- 10 个独立来源
- 收录于
- 今天
同类推荐
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。