Skip to main content
Glama
mcp-server-toolkit

mcp-server-toolkit

by sarmakska

mcp-server-toolkit

License: MIT Python FastAPI MCP OpenTelemetry Docker Open Source

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.

Related MCP server: MCP Server Templates

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

Umgebungsvariable

Zweck

Standardwert

MCP_TRANSPORT

stdio oder http

stdio

MCP_AUTH

none, api_key, oauth

none

OTEL_EXPORTER_OTLP_ENDPOINT

OTel-Collector-URL

nicht gesetzt

SARMALINK_API_KEY

für das sarmalink-Plugin

nicht gesetzt

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A production-ready MCP server scaffold that features built-in authentication, Docker support, and a comprehensive CI/CD release pipeline. It provides a standardized template for deploying servers with multi-transport support and configurable read-only modes.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides production-grade starter templates for MCP servers with permission boundaries, integration tests, and eval contracts, enabling rapid development of secure and testable MCP servers.
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      A production-ready foundation for building secure, observable MCP servers with built-in authentication, rate limiting, and reference tools like database-query and semantic-search.
      15
      20 npm
      MIT