Docker Compose для серверов протокола Model Context. Запустите несколько MCP-серверов с унифицированной конфигурацией, HTTP-прокси и оркестрацией контейнеров.

Особенности

• конфигурация YAML в стиле Docker Compose HTTP-прокси с автоматическим переводом протокола (STDIO → HTTP) Родная поддержка Docker и Podman
• Управление сеансами и объединение соединений
• Встроенная приборная панель и мониторинг
• OpenAPI Spec Generation

##Установка

Быстрый старт

Интерактивная настройка

Следуйте инструкциям, чтобы создать свою конфигурацию.

Ручная настройка

Создать [[Т0]]:

Запуск серверов:

Запустите HTTP-прокси:

Проверьте:

Рабочие примеры

Файловая система + память

###С помощью веб-поиска

Добавить Brave Search (требуется ключ API от https://brave.com/search/api/):)

См. примеры для более конфигураций.

Команды

###Управление сервисом

Системные сервисы

Системные сервисы представляют собой компоненты инфраструктуры (прокси, приборная панель, планировщик задач, память).

###Прокси

Панель управления

Конфигурация

Конфигурационная ссылка

###Базовая структура

Типы протоколов

STDIO (наиболее распространены для пакетов NPM):

HTTP:

SSE (события, отправленные сервером):

###Горные горы

Переменные среды

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