mcp-server-toolkit

Produktionsbereiter Model Context Protocol Server-Starter mit Authentifizierung, Tracing und einem Plugin-System.

Erstellt von Sarma Linux.

Was ist das?

MCP entwickelte sich Ende 2025 von einer Nischenspezifikation zur Standard-Integrationsschicht. Jeder ernstzunehmende Agent spricht es mittlerweile. Die meisten Referenzserver sind Spielereien: ein einzelnes Tool, keine Authentifizierung, keine Observability. Dieses Toolkit ist die meinungsstarke Alternative mit „Batteries-included“-Ansatz.

Erstellen Sie ein MCP-Server-Grundgerüst mit einem Befehl. Legen Sie Tool-Handler in ein Plugin-Verzeichnis. Erhalten Sie OAuth 2.1 mit PKCE, strukturiertes Logging, OpenTelemetry-Traces, Ratenbegrenzung und eine typisierte Tool-Registry kostenlos dazu. Läuft über stdio für lokale Agenten und streambares HTTP für entfernte Agenten, bei gleichem Code-Pfad.

Architektur

graph TD
  Client[MCP Client<br/>Desktop / Cursor / IDE]
  Client -->|stdio JSON-RPC| Stdio[stdio transport]
  Client -->|streamable HTTP| HTTP[FastAPI HTTP transport]
  Stdio --> Reg[Tool Registry]
  HTTP --> Auth[OAuth 2.1 / API key]
  Auth --> Reg
  Reg --> P1[plugin: filesystem]
  Reg --> P2[plugin: postgres]
  Reg --> P3[plugin: github]
  Reg --> P4[plugin: sarmalink]
  P4 -->|api.sarmalink.ai| SLAI[SarmaLink-AI]

  classDef ext fill:#a78bfa,stroke:#a78bfa,color:#fff
  class SLAI ext

Schnellstart

git clone https://github.com/sarmakska/mcp-server-toolkit.git
cd mcp-server-toolkit
uv sync
cp .env.example .env
uv run mcp-toolkit run --transport stdio

Plugin-Entwicklung

from mcp_toolkit.registry import registry

@registry.tool("search_docs", description="Search internal docs")
async def search_docs(query: str) -> dict:
    return {"results": [...]}

Konfiguration

Bereitstellung

Distroless Docker-Image, ca. 120 MB. Läuft auf Fly.io, Render, Railway, k8s.

docker build -t mcp-toolkit .
docker run -p 8000:8000 --env-file .env mcp-toolkit

Roadmap

Siehe docs/OPEN-ISSUES.md. Pull Requests sind willkommen.

Lizenz

MIT.

Erstellt von Sarma Linux.