MCP-Server-Vorlage (Python)

Eine minimale Model Context Protocol-Servervorlage für Render. Forke sie, füge deine eigenen Tools hinzu und stelle sie bereit.

Was enthalten ist

• Ein funktionierender MCP-Server mit dem MCP Python SDK und Streamable-HTTP-Transport

• Bearer-Token-Authentifizierung über MCP_API_TOKEN (wird beim Deployment automatisch generiert)

• Ein Beispiel-Tool (hello), um das Muster zu zeigen

• Ein /health-Endpunkt für die Health-Checks von Render

• Ein render.yaml-Blueprint für die Ein-Klick-Bereitstellung

• Eine AGENTS.md, damit KI-Coding-Assistenten neue Tools für dich erstellen können

Hinweis: Diese Vorlage wird standardmäßig im kostenlosen Plan bereitgestellt. Kostenlose Services werden nach 15 Minuten Inaktivität heruntergefahren, was beim nächsten Request zu Kaltstarts von 30-60 Sekunden führt. MCP-Clients können während dieser Verzögerung eine Zeitüberschreitung erleiden. Für eine zuverlässige Nutzung upgrade im Render Dashboard auf einen kostenpflichtigen Plan – der Starter-Plan hält deinen Service dauerhaft am Laufen.

Related MCP server: MCP Server Template (Python)

Lokale Einrichtung

git clone https://github.com/render-examples/mcp-server-python.git
cd mcp-server-python
pip install -r requirements.txt
python server.py

Der Server startet unter http://localhost:10000. Der MCP-Endpunkt befindet sich unter /mcp.

Tests ausführen

pip install -r requirements.txt
pytest

Authentifizierung

Der Server authentifiziert Anfragen mithilfe eines Bearer-Tokens. Das Blueprint von Render generiert beim ersten Deployment automatisch ein zufälliges MCP_API_TOKEN.

Um dein Token nach dem Deployment zu finden, gehe zu Render Dashboard > dein Service > Environment und kopiere den Wert von MCP_API_TOKEN.

Clients müssen das Token im Authorization-Header angeben:

Authorization: Bearer YOUR_TOKEN

Wenn MCP_API_TOKEN nicht gesetzt ist (z. B. während der lokalen Entwicklung), ist die Authentifizierung deaktiviert und alle Anfragen werden durchgelassen.

Tokenverwaltung

Nach dem ersten Deployment liegt die Verwaltung des Tokens bei dir:

• Rotiere es, indem du MCP_API_TOKEN im Render Dashboard unter Environment aktualisierst. Der Service startet automatisch mit dem neuen Wert neu.

• Generiere ein neues Token mit einer der folgenden Methoden:

  • openssl rand -base64 32

  • python3 -c "import secrets; print(secrets.token_urlsafe(32))"

  • Einen Passwortmanager-Generator (1Password, Bitwarden usw.)

• Commite keine Tokens in die Versionskontrolle. Verwende Umgebungsvariablen oder .env-Dateien (die in .gitignore aufgeführt sind).

• Für Multi-User- oder Produktionsumgebungen solltest du in Betracht ziehen, auf OAuth 2.1 zu upgraden.

Verbindung zu deinem MCP-Server

Nach dem Deployment auf Render ist dein MCP-Endpunkt verfügbar unter:

https://your-service-name.onrender.com/mcp

Cursor

Füge zur .cursor/mcp.json deines Projekts Folgendes hinzu:

{
  "mcpServers": {
    "my-mcp-server": {
      "url": "https://your-service-name.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Claude Desktop

Füge zur Konfiguration von Claude Desktop Folgendes hinzu:

{
  "mcpServers": {
    "my-mcp-server": {
      "type": "streamable-http",
      "url": "https://your-service-name.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Codex

codex mcp add --transport streamable-http \
  --url https://your-service-name.onrender.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN" \
  my-mcp-server

Oder füge zu .codex/config.toml Folgendes hinzu:

[mcp_servers.my-mcp-server]
url = "https://your-service-name.onrender.com/mcp"
http_headers = { Authorization = "Bearer YOUR_TOKEN" }

Tools hinzufügen

Füge Tools zu server.py hinzu, indem du eine Funktion mit @mcp.tool() dekorierst:

@mcp.tool()
def fetch_weather(city: str, units: str = "celsius") -> str:
    """Get the current weather for a city."""
    # your implementation here
    return f"Weather for {city}"

Der Docstring dient als Beschreibung des Tools, die MCP-Clients den LLMs anzeigen. Schreibe immer einen klaren Docstring.

Dieses Repository enthält eine AGENTS.md-Datei. Wenn du einen KI-Coding-Assistenten (Cursor, Copilot, Codex, Windsurf usw.) verwendest, kannst du ihn bitten, „ein neues Tool hinzuzufügen“, und er folgt automatisch den Konventionen in AGENTS.md.

Projektstruktur

server.py              MCP server with example tool and health check
requirements.txt       Python dependencies
render.yaml            Render Blueprint for deployment
.env.example           Environment variable reference
tests/test_server.py   Test suite (auth, health, tool calls)
pyproject.toml         pytest configuration
AGENTS.md              Instructions for AI coding assistants
CLAUDE.md              Pointer to AGENTS.md for Claude Code

Weitere Informationen

• MCP-Spezifikation

• MCP Python SDK

• Render Blueprints