MCP-Server-Vorlage (Python)

Eine minimale Model Context Protocol-Server-Vorlage für Render. Forken Sie sie, fügen Sie eigene Tools hinzu und stellen Sie 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 bei der Bereitstellung automatisch generiert)

• Ein Beispiel-Tool (hello), das das Muster zeigt

• Einen /health-Endpunkt für Render-Health-Checks

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

• Eine AGENTS.md, damit KI-Codierungsassistenten neue Tools für Sie erstellen können

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

Related MCP server: MCP Server Template (TypeScript)

Erste Schritte lokal

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 auf http://localhost:10000. Der MCP-Endpunkt befindet sich unter /mcp.

Tests ausführen

pip install -r requirements.txt
pytest

Authentifizierung

Der Server authentifiziert Requests mithilfe eines Bearer-Tokens. Das Render-Bluprint generiert beim ersten Bereitstellen automatisch ein zufälliges MCP_API_TOKEN.

So finden Sie Ihr Token nach der Bereitstellung: Gehen Sie zu Render-Dashboard > Ihr Dienst > Environment und kopieren Sie 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 Requests werden durchgelassen.

Ihr Token verwalten

Nach der ersten Bereitstellung gehört das Token Ihnen:

• Rotieren Sie es, indem Sie MCP_API_TOKEN im Render-Dashboard unter Environment aktualisieren. Der Dienst startet automatisch mit dem neuen Wert neu.

• Generieren Sie ein neues Token mit einem der folgenden Befehle:

  • openssl rand -base64 32

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

  • Den Generator eines Passwortmanagers (1Password, Bitwarden usw.)

• Committen Sie keine Tokens in die Versionskontrolle. Verwenden Sie Umgebungsvariablen oder .env-Dateien (diese sind in .gitignore).

• Für Multi-User- oder Produktionsumgebungen sollten Sie ein Upgrade auf OAuth 2.1 in Betracht ziehen.

Verbinden mit Ihrem MCP-Server

Nach der Bereitstellung auf Render ist Ihr MCP-Endpunkt verfügbar unter:

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

Cursor

Fügen Sie zu .cursor/mcp.json in Ihrem Projekt hinzu:

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

Claude Desktop

Fügen Sie zu Ihrer Claude-Desktop-Konfiguration 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ügen Sie zu .codex/config.toml hinzu:

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

Tools hinzufügen

Fügen Sie Tools zu server.py hinzu, indem Sie eine Funktion mit @mcp.tool() dekorieren:

@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 wird zur Beschreibung des Tools, die MCP-Clients den LLMs anzeigen. Schreiben Sie immer einen klaren Docstring.

Dieses Repository enthält eine AGENTS.md. Wenn Sie einen KI-Codierungsassistenten (Cursor, Copilot, Codex, Windsurf usw.) verwenden, können Sie 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

Mehr erfahren

• MCP-Spezifikation

• MCP Python SDK

• Render-Blueprints