la-caja-mcp

La Caja(컨텍스트 메모리)에 대한 접근 및 토론을 위한 MCP 시스템. Repo B: La Caja(repo A)의 소비자. 이 repo는 메모리 코어를 건드리지 않으며, API를 통해 통신하고 La Caja를 에이전트에 노출합니다.

여기 있는 것들

• src/la_caja_mcp/protocolo.py — 에이전트-에이전트-인간 토론 프로토콜. 주장, 간섭 요청, 마감 기한이 있는 라운드, 인간 판정. 결정론적이며 재생 가능(이벤트 소싱, La Caja와 동일한 규율).

• src/la_caja_mcp/mcp_server.py — MCP 서버: 토론 도구 + La Caja(repo A, API로 소비)의 메모리 도구, 단일 도구 세트 및 두 가지 전송 방식(로컬 stdio / 원격 streamable HTTP).

• tests/ — 상태 머신의 미니 반증 + stdio를 통한 실제 MCP 클라이언트와의 통합(토론 및 메모리).

• demo_debate.py — 합의로 종료되는 토론 데모.

• smoke_http.py — streamable HTTP 전송의 스모크 테스트.

• worker/ — 원격 MCP를 위한 이식 가능한 ASGI 호스트(uvicorn + Dockerfile).

Related MCP server: Arena MCP Server

MCP 서버

하나의 도구 세트, 두 가지 전송 방식:

# 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

토론: crear_sesion, mover (JSON 페이로드), estado, ultimos_eventos, reproducir_sesion. 메모리 (pip install la-caja 필요; repo A): procesar_consulta, declarar_relacion, consultar, contexto_primado, stats.

메모리는 --caja-db <ruta>(SQLite, La Caja의 이벤트 소싱) 또는 LA_CAJA_DB로 지속 가능하며, 그렇지 않으면 순수 메모리입니다.

MCP 전송 방식 (아키텍처 결정)

• 로컬 = stdio (에이전트가 서버를 하위 프로세스로 실행).

• 원격 = streamable HTTP (원격 MCP의 유일한 표준, + OAuth).

• worker/는 배포 가능한 호스트 예제(VPS/Docker)이며, 호스팅된 공개 MCP는 없습니다.

테스트

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