riskrouter-recorder

Servidor MCP local que registra las decisiones de un agente de IA como evidencia. El registro permanece en tu propio diario; solo su SHA-256 con sal se envía a un registro a prueba de manipulaciones, y sin una clave nada sale de la máquina.

Documentación

riskrouter-recorder

Grabadores integrables para Python y Node, sin dependencias, que convierten los registros de decisiones que ya mantienes en evidencia. Cada registro y su sal permanecen en tu propio diario; solo el SHA-256 con sal del registro y un tipo corto se envían a un registro de evidencia, de modo que más tarde cualquiera que tenga el registro pueda verificar que nunca fue modificado. El registro puede ser el de RiskRouter (https://api.riskrouter.eu), tu propia instancia, o ninguno: sin clave, no se envía nada y el diario lo conserva todo.

InstalarLeer
Python 3.8+pip install riskrouter-recorderpython/README.md
Node 20+npm install riskrouter-recorderjs/README.md

Qué contienen:

  • un grabador con diario local, agrupación por lotes, reintentos y cadenas de completitud;
  • un manejador de logging para Python, un decorador (Python) o envoltorio de función (Node), y procesadores de tramos de OpenTelemetry;
  • adaptadores de agentes para LangChain y LangGraph y para el SDK de Agentes de OpenAI: un registro por ejecución, con resúmenes de contenido, nunca el contenido;
  • un servidor MCP local (Node, riskrouter-recorder-mcp) que brinda a cualquier cliente MCP una herramienta record_decision. Registra la propia declaración del agente sobre lo que decidió y marca cada registro como tal; nunca devuelve un registro o una sal al agente;
  • riskrouter-logseal, que sella un flujo de registro segmento por segmento, y riskrouter-otlp-sealer, que sella tramos y registros de registro en el Colector de OpenTelemetry.
npx -y -p riskrouter-recorder riskrouter-recorder-mcp     # the local MCP server, over stdio

En la configuración de un cliente MCP (pasos de configuración para un asistente: llms-install.md):

{ "mcpServers": { "riskrouter-recorder": { "command": "npx",
    "args": ["-y", "-p", "riskrouter-recorder", "riskrouter-recorder-mcp"],
    "env": { "RISKROUTER_JOURNAL": "/absolute/path/to/evidence-journal.jsonl" } } } }

Sus herramientas son record_decision, evidence_lookup y evidence_status; solo record_decision escribe, y nada elimina. Con RISKROUTER_API_KEY configurado, el resumen con sal de cada registro va al registro; sin él, nada sale de la máquina.

RiskRouter también ejecuta un punto final MCP alojado para leer el registro y sus pruebas, en https://api.riskrouter.eu/mcp (eu.riskrouter/evidence-log en el Registro MCP oficial). Ese es el servicio, no este paquete.

Comprobación de lo registrado

El paquete de un registro se verifica sin conexión, sin RiskRouter, mediante cualquiera de los verificadores de código abierto en https://github.com/aniljangrabe-dev/riskrouter-verify. El formato del registro, el resumen con sal y las pruebas del registro se especifican en https://riskrouter.eu/spec.

Acerca de este repositorio

Este repositorio es una copia exacta de recorders/ en el repositorio propio de RiskRouter, que es privado; un flujo de trabajo copia cada cambio aquí cuando llega allí. Los problemas son bienvenidos aquí, y una solicitud de extracción se lee y, si se acepta, se aplica en la fuente y se copia de vuelta. Informa un problema de seguridad como dice https://riskrouter.eu/security, no en un problema.

Licencia: Apache-2.0 (LICENSE), como los verificadores, la suite de conformidad y el kit de integración. El servicio RiskRouter en sí no está licenciado.