Python MCP Server Kit

Ein reines Backend-Starterset für sichere, typisierte und testbare Model-Context-Protocol-Server. Es zielt auf das MCP-Protokoll 2026-07-28 über das offizielle Python-SDK v2 ab und verwendet zustandsloses Streamable HTTP für die Bereitstellung.

Funktionen

• Typisierte Tools mit strukturierter Pydantic-Ausgabe

• Generische Rechner- und deterministische Katalogbeispiele

• MCP-Tools, -Ressourcen und -Prompts

• Bearer-Token-Grenze und Pro-Tool-Scopes

• Anfragegrößen-, Host- und In-Process-Ratenlimits

• Korrelations-IDs und strukturierte Anfrage-Logs

• Öffentliche Health- und Readiness-Probes

• Produktionsnahes Docker-Image ohne Root-Rechte

• CI für Linting, Formatierung, Typprüfung, Tests, Image-Build, Secrets und Workflows

Related MCP server: MCP TypeScript SDK

Architektur

HTTP request
  -> SecurityMiddleware (host, size, auth, rate limit, request ID)
  -> MCP Streamable HTTP transport
  -> typed tool/resource/prompt
  -> scope check
  -> deterministic domain function

Die Protokollregistrierung befindet sich in src/mcp_server_kit/server.py; wiederverwendbare Domänenlogik bleibt in separaten Modulen. TokenStore ist bewusst eine austauschbare Bereitstellungsgrenze und kein vollständiger Autorisierungsserver.

Schnellstart

Python 3.11+ ist erforderlich.

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"
Copy-Item .env.example .env
.\scripts\dev.ps1

Der MCP-Endpunkt ist http://127.0.0.1:8000/mcp. Health-Probes sind unter /health und /ready verfügbar. Die nur lokal verfügbaren Demo-Tokens sind:

• demo-reader — catalog:read

• demo-operator — catalog:read, calculator:use

Führen Sie den MCP Inspector mit npx -y @modelcontextprotocol/inspector aus und setzen Sie einen Authorization: Bearer demo-operator-Header. Eine anmeldefreie Client-Vorlage ist in examples/client.json verfügbar; injizieren Sie MCP_CLIENT_TOKEN lokal.

Befehle

.\scripts\dev.ps1    # development server with reload
.\scripts\check.ps1  # lint, format check, mypy, and tests
docker compose up --build

Konfiguration

Committen Sie niemals .env. Siehe Sicherheit und Bereitstellung, bevor Sie eine internetzugängliche Bereitstellung durchführen, und Tools hinzufügen, wenn Sie die Registry erweitern.

Hinweise zur Bereitstellung

Setzen Sie MCP_ENVIRONMENT=production, MCP_AUTH_MODE=bearer, einen über Secrets verwalteten Wert für MCP_BEARER_TOKENS und die exakte öffentliche Host-Allowlist. Beenden Sie TLS an einem vertrauenswürdigen Reverse-Proxy. Ersetzen Sie den Starter-Token-Store durch Ihren OAuth-2.1-Resource-Server-Verifier, wenn Benutzerdelegierung oder Token-Lebenszyklusverwaltung erforderlich ist.

Lizenz

MIT