la-caja-mcp

MCP-System für Zugriff und Diskussion über La Caja (kontextuelles Gedächtnis). Repo B: Konsument von La Caja (Repo A). Dieses Repo greift nicht in den Kern des Gedächtnisses ein; es kommuniziert über die API damit und stellt La Caja Agenten zur Verfügung.

Was hier enthalten ist

• src/la_caja_mcp/protocolo.py — Protokoll für die Agent-Agent-Mensch-Diskussion. Behauptungen, Anfragen zur Einmischung, Runden mit Frist, menschliche Entscheidung. Deterministisch und wiederholbar (Event-Sourcing, gleiche Disziplin wie La Caja).

• src/la_caja_mcp/mcp_server.py — MCP-Server: Tools für die Diskussion + Tools für das Gedächtnis von La Caja (Repo A, über API konsumiert), ein einziger Satz von Tools und zwei Transporte (lokal stdio / streamable HTTP remote).

• tests/ — Mini-Falsifikation des Zustandsautomaten + Integration mit echtem MCP-Client über stdio (Diskussion und Gedächtnis).

• demo_debate.py — Demo der Diskussion, die im Konsens endet.

• smoke_http.py — Smoke-Test des streamable HTTP-Transports.

• worker/ — Portabler ASGI-Host (uvicorn + Dockerfile) für den entfernten MCP.

Related MCP server: Arena MCP Server

MCP-Server

Ein Satz von Tools, zwei Transporte:

# local (stdio): lo lanza el agente como subproceso
la-caja-mcp --transport stdio

# remoto (streamable HTTP): unico standard para MCP sobre red
la-caja-mcp --transport streamable-http --host 127.0.0.1 --port 8000

Diskussion: crear_sesion, mover (JSON-Payload), estado, ultimos_eventos, reproducir_sesion. Gedächtnis (erfordert pip install la-caja; Repo A): procesar_consulta, declarar_relacion, consultar, contexto_primado, stats.

Das Gedächtnis ist persistent mit --caja-db <Pfad> (SQLite, Event-Sourcing von La Caja) oder LA_CAJA_DB; ohne dies, rein im Arbeitsspeicher.

MCP-Transporte (Architekturentscheidung)

• Lokal = stdio (der Agent startet den Server als Unterprozess).

• Remote = streamable HTTP (einziger Standard für entfernten MCP, + OAuth).

• worker/ ist ein Beispiel für einen bereitstellbaren Host (VPS/Docker); es gibt keinen gehosteten öffentlichen MCP.

Testen

$env:PYTHONPATH="src"; python -m pytest tests -q