MCP Collection

🚀 MCP‑Collection

A Docker image that packages multiple Model‑Context‑Protocol (MCP) servers and exposes them through a unified entry point.

🚀 Quick Start

To get started with the MCP‑Collection Docker image, follow these steps:

# Pull the multi-architecture image
docker pull ghcr.io/erhardtconsulting/mcp‑collection:1.0.0

# List available MCP servers (show help information)
docker run --rm ghcr.io/erhardtconsulting/mcp‑collection

# Run the Git server and pass additional parameters to the underlying CLI
docker run --rm -p 8080:8080 \
  ghcr.io/erhardtconsulting/mcp‑collection mcp-server-fetch --test

Included MCP Servers

✨ Features

• One Image – Multiple Servers: Select the desired MCP server at runtime with a single parameter.
• Remote-Ready, Out-of-the-Box: The built-in supergateway bridges the server's stdio interface to HTTP/SSE or WebSocket.
• Kubernetes-First Design: Includes built-in health endpoints, runs as a non-root user, and has a minimal distroless runtime layer (≤80MB).
• Deterministic Builds: Uses uv.lock to lock Python dependencies, disallowing runtime installation or updates.

🐳 Image Layout

/mcp-collection
├── root
     ├── docker-entrypoint.sh # Select and validate the server, start supergateway
     ├── .venv/              # Isolated Python environment for all MCP servers
     ├── node_modules/       # Isolated Node environment for all MCP servers
     ├── pyproject.toml      # List of Python MCP server dependencies
     └── package.json        # List of Node MCP server dependencies

The entry point performs the following steps:

1. Activate the virtual environment (.venv).
2. Read a fixed whitelist (ALLOWED_SERVERS).
3. Validate the server name provided by the user.
4. Execute supergateway --stdio "<server> [additional parameters]".

☸️ Kubernetes Deployment Example

apiVersion: apps/v1
kind: Deployment
metadata:
  name: mcp-collection
spec:
  selector:
    matchLabels: {app: mcp-collection}
  template:
    metadata:
      labels: {app: mcp-collection}
    spec:
      containers:
      - name: mcp
        image: ghcr.io/erhardtconsulting/mcp-collection:1.0.0
        args: ["mcp-server-kubernetes"]
        ports:
        - containerPort: 8080

⚠️ Important Note

• The image runs as a non-root user by default.
• Shell access is not allowed to ensure container security.

📋 Contribution Guidelines

• Forks and pull requests are welcome!
• Before submitting, please read CONTRIBUTING.md.