mcp-server/compose.yml at main · openapi/mcp-server · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
# =============================================================================
# mcp.openapi.com MCP Gateway — Docker Compose
# =============================================================================
# Default setup: production-like image built from ./docker/latest/
#
# DEVELOPMENT / DEBUG
# To enable Python remote debugging with VS Code, switch the Dockerfile:
#
#   dockerfile: ./docker/dev/Dockerfile
#
# The dev image adds debugpy (port 5678), mounts the source tree for live
# code changes, and sets PYDEVD_DISABLE_FILE_VALIDATION=1.
# See the "Debug and Development" section in README.md for the full procedure.
# =============================================================================

services:
  mcp-server:
    container_name: mcp-server
    build:
      context: .
      # Switch to ./docker/dev/Dockerfile or ./docker/latest/Dockerfile as needed.
      dockerfile: ./docker/dev/Dockerfile
    environment:
      - MCP_PORT=8080
    ports:
      - "8080:8080"
      # Debugpy for remote debugging (only in dev Dockerfile)
      - "5678:5678"
    volumes:
      - type: bind
        source: ./src
        target: /app/src
    restart: unless-stopped

  # ---------------------------------------------------------------------------
  # MCP Inspector — visual tool for inspecting and debugging the MCP server
  # ---------------------------------------------------------------------------
  # Open in the browser:
  #   http://localhost:6274
  #
  # Once open, connect to the MCP server using these settings:
  #   Transport : Streamable HTTP
  #   Server URL: http://mcp:8080
  #
  # The inspector proxy (port 6277) runs inside the Docker network and reaches
  # the mcp service via its Docker hostname — no need to expose extra ports.
  #
  # Pre-configured deep-link (one click):
  #   http://localhost:6274?transport=streamable-http&serverUrl=http://mcp:8080
  # ---------------------------------------------------------------------------
  mcp-inspector:
    image: ghcr.io/modelcontextprotocol/inspector:latest
    container_name: mcp-inspector
    environment:
      - HOST=0.0.0.0
      # Disable automatic browser opening inside the container (headless).
      - MCP_AUTO_OPEN_ENABLED=false
    ports:
      - "6274:6274"   # Web UI
      - "6277:6277"   # Proxy backend (bridges browser ↔ MCP server)
    depends_on:
      - mcp-server
    restart: unless-stopped