pjt222/containerize-mcp-server

MCP-Server containerisieren

Einen R-MCP-Server in einen Docker-Container fuer portables Deployment verpacken.

Wann verwenden

• Deployen eines R-MCP-Servers ohne lokale R-Installation
• Erstellen einer reproduzierbaren MCP-Server-Umgebung
• Betrieb von MCP-Servern neben anderen containerisierten Diensten
• Verteilen eines MCP-Servers an andere Entwickler

Eingaben

• Erforderlich: R-MCP-Server-Implementierung (mcptools-basiert oder benutzerdefiniert)
• Erforderlich: Docker installiert und laufend
• Optional: Zusaetzliche R-Pakete, die der Server benoetigt
• Optional: Transportmodus (stdio oder HTTP)

Vorgehensweise

Schritt 1: Dockerfile fuer MCP-Server erstellen

FROM rocker/r-ver:4.5.0

# Systemabhaengigkeiten installieren
RUN apt-get update && apt-get install -y \
    libcurl4-openssl-dev \
    libssl-dev \
    libxml2-dev \
    libgit2-dev \
    libssh2-1-dev \
    git \
    curl \
    && rm -rf /var/lib/apt/lists/*

# R-Pakete installieren
RUN R -e "install.packages(c( \
    'remotes', \
    'ellmer' \
    ), repos='https://cloud.r-project.org/')"

# mcptools installieren
RUN R -e "remotes::install_github('posit-dev/mcptools')"

# Arbeitsverzeichnis setzen
WORKDIR /workspace

# MCP-Server-Ports freigeben
EXPOSE 3000 3001 3002

# Umgebungsvariablen
ENV R_LIBS_USER=/workspace/renv/library
ENV RENV_PATHS_CACHE=/workspace/renv/cache

# Standard: MCP-Server starten
CMD ["R", "-e", "mcptools::mcp_server()"]

Erwartet: Ein Dockerfile existiert im Projektstamm mit rocker/r-ver-Basisimage, Systemabhaengigkeiten, mcptools-Installation und dem MCP-Server als Standardbefehl.

Bei Fehler: Sicherstellen, dass das Basisimage-Tag zur R-Version passt. Wenn remotes::install_github fehlschlaegt, pruefen, ob git und libgit2-dev im Systemabhaengigkeiten-Layer enthalten sind.

Schritt 2: docker-compose.yml erstellen

version: '3.8'

services:
  mcp-server:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: r-mcp-server
    image: r-mcp-server:latest

    volumes:
      - /path/to/projects:/workspace
      - renv-cache:/workspace/renv/cache

    stdin_open: true
    tty: true

    network_mode: "host"

    environment:
      - TERM=xterm-256color
      - R_LIBS_USER=/workspace/renv/library

    restart: unless-stopped

volumes:
  renv-cache:
    driver: local

Die Verwendung von network_mode: "host" stellt sicher, dass die MCP-Server-Ports auf localhost erreichbar sind.

Erwartet: Eine docker-compose.yml-Datei im Projektstamm mit dem MCP-Server-Dienst, Volume-Mounts fuer Projektdateien und renv-Cache sowie aktiviertem stdin_open/tty fuer stdio-Transport.

Bei Fehler: Wenn Volume-Pfade ungueltig sind, /path/to/projects an das tatsaechliche Projektverzeichnis anpassen. Unter Windows/WSL /mnt/c/...- oder /mnt/d/...-Pfade verwenden.

Schritt 3: Bauen und Starten

docker compose build
docker compose up -d

Erwartet: Container startet mit laufendem MCP-Server.

Bei Fehler: Logs mit docker compose logs mcp-server pruefen. Haeufige Probleme:

• Fehlende R-Pakete: Zum Dockerfile-RUN-Installationsschritt hinzufuegen
• Port bereits belegt: Freigegebenen Port aendern oder kollidierenden Dienst stoppen

Schritt 4: Claude Code mit Container verbinden

Fuer stdio-Transport (Container muss mit stdin weiterlaufen):

claude mcp add r-mcp-docker stdio "docker" "exec" "-i" "r-mcp-server" "R" "-e" "mcptools::mcp_server()"

Fuer HTTP-Transport (wenn der MCP-Server dies unterstuetzt):

{
  "mcpServers": {
    "r-mcp-docker": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

Erwartet: Die MCP-Konfiguration von Claude Code enthaelt den r-mcp-docker-Servereintrag, und claude mcp list zeigt den neuen Server.

Bei Fehler: Fuer stdio-Transport sicherstellen, dass der Containername uebereinstimmt (r-mcp-server) und der Container mit docker ps laeuft. Fuer HTTP-Transport pruefen, ob der Port freigegeben und mit curl http://localhost:3000/mcp erreichbar ist.

Schritt 5: Verbindung ueberpruefen

# Pruefen, ob Container laeuft
docker ps | grep mcp-server

# R-Sitzung im Container testen
docker exec -it r-mcp-server R -e "sessionInfo()"

# Pruefen, ob mcptools verfuegbar ist
docker exec -it r-mcp-server R -e "library(mcptools)"

Erwartet: docker ps zeigt den r-mcp-server-Container als laufend, sessionInfo() gibt die erwartete R-Version zurueck, und library(mcptools) wird fehlerfrei geladen.

Bei Fehler: Wenn der Container nicht laeuft, docker compose logs mcp-server auf Startfehler pruefen. Wenn mcptools nicht geladen werden kann, das Image neu bauen, um sicherzustellen, dass das Paket korrekt installiert wurde.

Schritt 6: Benutzerdefinierte MCP-Tools hinzufuegen

Um projektspezifische MCP-Tools hinzuzufuegen, R-Skripte einhaengen:

volumes:
  - ./mcp-tools:/mcp-tools

Und im CMD laden:

CMD ["R", "-e", "source('/mcp-tools/custom_tools.R'); mcptools::mcp_server()"]

Erwartet: Benutzerdefinierte R-Skripte sind im Container unter /mcp-tools/ zugaenglich, und der MCP-Server laedt sie beim Start neben den Standardtools.

Bei Fehler: Sicherstellen, dass der Volume-Mount-Pfad korrekt ist, mit docker exec -it r-mcp-server ls /mcp-tools/ pruefen. Wenn Skripte nicht gesourced werden koennen, fehlende Paketabhaengigkeiten in den benutzerdefinierten Tools pruefen.

Validierung

• [ ] Container wird fehlerfrei gebaut
• [ ] MCP-Server startet im Container
• [ ] Claude Code kann sich mit dem containerisierten Server verbinden
• [ ] MCP-Tools antworten korrekt auf Anfragen
• [ ] Container startet sauber neu
• [ ] Volume-Mounts ermoeglichen Zugriff auf Projektdateien

Haeufige Fehler

• stdin/tty-Anforderungen: MCP-stdio-Transport erfordert stdin_open: true und tty: true
• Netzwerkisolation: Standard-Docker-Netzwerk kann Localhost-Zugriff verhindern. network_mode: "host" verwenden oder bestimmte Ports freigeben.
• Paketversionen: mcptools auf einen bestimmten Commit fuer Reproduzierbarkeit pinnen.
• Grosse Image-Groesse: mcptools + Abhaengigkeiten koennen gross sein. Multi-Stage-Builds fuer Produktion in Betracht ziehen.
• Windows-Docker-Pfade: Bei Docker Desktop unter Windows mit WSL unterscheidet sich das Pfad-Mapping.

Verwandte Skills

• create-r-dockerfile - Basis-Dockerfile-Muster fuer R
• setup-docker-compose - Details zur Compose-Konfiguration
• configure-mcp-server - MCP-Server-Konfiguration ohne Docker
• troubleshoot-mcp-connection - Debugging von MCP-Verbindungsproblemen