Statewave

Servidor MCP para Statewave, un runtime de memoria de código abierto para agentes de IA. Proporciona memoria persistente, recuperación de contexto y compilación de memoria a través del Protocolo de Contexto del Modelo.

GitHub

Prueba este MCPPatrocinado

Documentación

@statewavedev/mcp-server

Servidor MCP de Statewave: expone la memoria de Statewave a clientes compatibles con MCP (asistentes de codificación, marcos de agentes, extensiones de IDE).

Parte del ecosistema Statewave Connectors. Neutral respecto al proveedor por diseño: sin suposiciones de IDE, proveedor de modelos ni dependencias alojadas.

Qué hay aquí

STATEWAVE_MCP_TOOLS — la superficie de herramientas canónica (5 herramientas, entrada JSON Schema)
StatewaveClient — cliente HTTP ligero para la API v1 de Statewave (autenticación, inquilino, errores tipados)
dispatchTool — despachador que valida la entrada y asigna una llamada de herramienta a un método de StatewaveClient
startMcpServer — transporte mínimo stdio JSON-RPC 2.0, además de un modo --list-tools

Herramientas

Herramienta	Propósito
`statewave_ingest_episode`	Ingerir un único episodio normalizado (deduplicado en `idempotency_key`).
`statewave_search_memories`	Buscar memorias compiladas mediante consulta de texto libre dentro de un sujeto.
`statewave_get_context`	Recuperar contexto compacto y clasificado para un sujeto: la herramienta predeterminada para usar dentro de un prompt.
`statewave_get_timeline`	Episodios cronológicos para un sujeto; filtrables por `kinds`, `since`, `until`.
`statewave_compile_subject`	Activar la compilación de un sujeto para que los episodios recién ingeridos se puedan recuperar.

Uso

# As a CLI subcommand (via @statewavedev/connectors-cli)
statewave-connectors mcp start --list-tools     # print the JSON Schema surface and exit
statewave-connectors mcp start                  # stdio JSON-RPC 2.0 server (requires STATEWAVE_URL)

# Or programmatically inside an existing MCP runtime
import { StatewaveClient, dispatchTool } from "@statewavedev/mcp-server";
const client = new StatewaveClient({ url: process.env.STATEWAVE_URL!, apiKey: process.env.STATEWAVE_API_KEY });
const { result } = await dispatchTool(client, "statewave_get_context", {
  subject: "repo:owner/name",
  query: "repo conventions and recent changes",
});

Estado

Vista previa v0.1.0: se incluye transporte mínimo stdio. Consulta RELEASE_NOTES.md.