mcp-agent-kit

Ein reiner, auf der Standardbibliothek basierender Model Context Protocol (MCP)-Server & Tool-Harness für Claude Desktop, Cursor und autonome Agentenflotten.

Schnellstart • Architektur • Claude-Desktop-Einrichtung • Vergleich • Technische Sorgfalt

Architektur

Related MCP server: MCP-123

Warum mcp-agent-kit?

Die offiziellen MCP-SDKs bringen dutzende schwergewichtige Drittanbieter-Abhängigkeiten mit (pydantic, anyio, httpx, starlette), wodurch unnötige Supply-Chain-Angriffsflächen und Installationshürden in Unternehmensumgebungen entstehen.

mcp-agent-kit bietet eine vollständige, produktionsreife Implementierung des Model Context Protocol, die zu 100 % auf der Python-Standardbibliothek basiert:

• 🚀 Null Laufzeitabhängigkeiten: Reines Python (json, sys, inspect, dataclasses).

• 🔒 Enterprise-tauglich: Sofortige Auditierbarkeit ohne jegliche Gefährdung durch Paket-Schwachstellen.

• ⚡ Ultra-leichtgewichtig: Startzeit unter einer Millisekunde, ideal für CLI-Tools, serverlose Umgebungen und eingebettete Forward-Deployed-Agent-Integrationen.

• 🛠️ Automatische Schema-Generierung: Leitet JSON-Schema-Definitionen direkt aus nativen Python-Typannotationen und Docstrings ab.

mcp-agent-kit vs. offizielles MCP-SDK

Schnellstart

1. Einen MCP-Server in 20 Zeilen erstellen

from mcp_agent_kit import MCPServer

app = MCPServer(name="my-agent-tools", version="1.0.0")

@app.tool(description="Calculate tax and total invoice amounts")
def calculate_invoice(subtotal: float, tax_rate: float = 0.07) -> dict:
    tax = round(subtotal * tax_rate, 2)
    return {"subtotal": subtotal, "tax": tax, "total": round(subtotal + tax, 2)}

if __name__ == "__main__":
    app.run_stdio()

Claude-Desktop-Integration

Fügen Sie Ihren Server direkt zur claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "my-tools": {
      "command": "python",
      "args": ["-m", "examples.simple_server"]
    }
  }
}

Starten Sie Claude Desktop neu, und Ihre benutzerdefinierten Tools erscheinen sofort in Claudes Werkzeuggürtel! 🔨

Funktionen

• Vollständiger MCP-Handshake: initialize, notifications/initialized, ping.

• Dynamische Tool-Entdeckung: tools/list mit automatischer JSON-Schema-Generierung.

• Robuste Fehlergrenzen: tools/call isoliert Laufzeitausnahmen von Tools und meldet strukturierte Fehlermeldungen an das LLM zurück, ohne den stdio-Prozess zum Absturz zu bringen.

• Null Abhängigkeiten: Läuft ohne Weiteres auf Python 3.10+.

Technische Sorgfalt und Verifizierung

• Tests: 100 % bestandene pytest-Testsuite, die Initialisierung, Tool-Entdeckung, Argumentvalidierung und Ausnahmebehandlung abdeckt.

• Abhängigkeiten: 0 Laufzeitabhängigkeiten.

• Autor: Reuben Bowlby — LinkedIn | Lebenslauf

Enterprise-Skalierung

mcp-agent-kit ist Teil des HUMMBL-Entwicklerökosystems. Für Multi-Agent-Governance auf Unternehmensniveau (4-stufige Kill-Switches, HMAC-signierte Delegations-Tokens und kryptografische Audit-Busse) besuchen Sie github.com/hummbl-io.