Docker Compose for Model Context Protocol 서버. 통합 구성, HTTP 프록시 및 컨테이너 오케스트라를 가진 여러 MCP 서버를 실행합니다.

특징

• 도커 Compose-style YAML 구성
• 자동 프로토콜 번역 HTTP 프록시 (STDIO → HTTP)
• Docker 및 Podman의 기본 지원
• 세션 관리 및 연결 풀링
• 내장 대시보드 및 모니터링
• OpenAPI 사양 생성

설치

빠른 시작

Interactive 설정

구성을 만들기 위해 프롬프트를 따르십시오.

수동 설정

mcp-compose.yaml 만들기:

서버 시작:

HTTP 프록시 시작:

테스트:

작업 예제

Basic - 파일 시스템 + 메모리

웹 검색

Brave Search 추가 ([T1]]에서 API 키 필요

더 많은 구성 예제/ 보기.

명령

서비스 관리

시스템 서비스

시스템 서비스는 인프라 구성 요소 (proxy, 대쉬보드, 작업 스케줄러, 메모리)입니다.

프록시

대시보드

윤곽

구성 참조

기본 구조

프로토콜 유형

STDIO (NPM 패키지에 가장 일반적인):

HTTP:

SSE (Server-Sent Events):

볼륨 마운트

환경 변수

MCP-Compose

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

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

mcp-compose init

Follow the prompts to create your configuration.

Manual Setup

Create mcp-compose.yaml:

version: '1'
servers:
  filesystem:
    protocol: stdio
    command: npx
    args:
      - "-y"
      - "@modelcontextprotocol/server-filesystem"
      - "/tmp"
    capabilities: [resources, tools]

Start servers:

mcp-compose up

Start the HTTP proxy:

mcp-compose proxy --port 9876

Test it:

curl http://localhost:9876/api/servers

Working Examples

Basic - Filesystem + Memory

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/):

  brave-search:
    protocol: stdio
    command: npx
    args:
      - "-y"
      - "@modelcontextprotocol/server-brave-search"
    capabilities: [tools]
    env:
      BRAVE_API_KEY: "${BRAVE_API_KEY}"

export BRAVE_API_KEY="your-api-key"
mcp-compose up

See examples/ for more configurations.

Commands

Service Management

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