mcp-server-and-agent

Status: in Arbeit. Nur ein Grundgerüst, noch nicht implementiert. Diese README wird generierte Zahlen enthalten, sobald die ersten Ergebnisse vorliegen.

Ein handgeschriebener MCP-Server auf Protokollebene plus ein LangGraph-Agent darüber, mit vier Topologien, die gegen dieselbe Aufgabenmenge laufen, und ihren gemessenen Fehlermodi.

Dieses Repository beantwortet eine Frage:

Wie hoch ist die Fehlerrate jeder Agenten-Topologie, und schlägt der Supervisor tatsächlich den Single-Agenten?

Alles hier dient der Beantwortung dieser Frage. Funktionen, die nicht dazu beitragen, sind out of scope – bewusst.

Warum dieses Repository existiert

Schnellstart

uv sync --extra dev
uv run pytest -q
uv run python scripts/generate_results.py

Ergebnisse

Noch keine Ergebnisse.

Design-Entscheidungen

Einschränkungen

Behandelte Konzepte

• 2C handgeschriebener MCP-Server plus LangGraph-Agent (DO-8)

• 2C ReAct, Plan-and-Execute, Reflexion

• 2C Topologien und ihre Fehlermodi

• 2C Tool-Design: Schema-Klarheit, Granularität, Fehler als Modell-Feedback, Idempotenz, Bestätigungs-Gates

• 2C MCP als Protokoll: Transports, Discovery, Ressourcen, Prompts, Sampling, OAuth-Scope

• 2C Zustand und Gedächtnis, Checkpointing, dauerhafte Ausführung

• …und 4 weitere (siehe docs/inventory-coverage.md)

Lizenz

MIT