mcp-state

Un pizarrón SQLite integrado para agentes. Permite que los agentes de IA lean, modifiquen y archiven su estado sin saturar su contexto de conversación.

GitHubPrueba este MCPPatrocinado

Documentación

mcp-state

mcp-state es un servidor de Model Context Protocol (MCP) para la gestión de estado de agentes. Proporciona una arquitectura ligera y determinista de "pizarra" impulsada por una base de datos SQLite integrada, que permite a los agentes de IA leer, modificar y archivar su estado sin saturar su contexto de conversación.

Documentación

La documentación completa de Diataxis, los entornos de prueba interactivos de API y las guías arquitectónicas están disponibles en el sitio de documentación de mcp-state.

Características

Núcleo SQLite integrado: Sin servidores de base de datos que gestionar. Todo se almacena en un archivo blackboard.db local.
Parcheo JSON: Los agentes actualizan el estado de forma incremental mediante JSON-RPC.
Archivado en almacenamiento en frío: Los agentes pueden archivar subtareas completadas en una tabla cold_storage para preservar los límites de su ventana de contexto.
Servidor MCP nativo por stdio: Totalmente compatible con el estándar MCP 2024-11-05 a través de flujos de entrada/salida estándar.

Instalación

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/JohnnytheShark/mcp-state/master/install.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/JohnnytheShark/mcp-state/master/install.ps1 | iex

Desde el código fuente

cargo build --release

Inicio rápido

mcp-state se ejecuta a través de stdio y está diseñado para ser invocado por un cliente MCP (como Claude Desktop o Antigravity).

{
  "mcpServers": {
    "mcp-state": {
      "command": "mcp-state",
      "args": []
    }
  }
}

El servidor expone las siguientes herramientas:

read_blackboard(session_id)
patch_blackboard(session_id, json_patch)
archive_subtask(session_id, key_to_archive)

Licencia

Este proyecto está licenciado bajo la Apache License 2.0. Consulta los archivos LICENSE y NOTICE para más detalles.