Servidor MCP State | Awesome MCP Servers

mcp-state

mcp-state é um servidor Model Context Protocol (MCP) para gerenciamento de estado de agentes. Ele fornece uma arquitetura leve e determinística de "quadro negro" alimentada por um banco de dados SQLite embutido, permitindo que agentes de IA leiam, atualizem e arquivem seu estado sem poluir o contexto da conversa.

Documentação

Documentação Diataxis completa, playgrounds interativos de API e guias de arquitetura estão disponíveis no Site de Documentação do mcp-state.

Recursos

Núcleo SQLite Embutido: Zero servidores de banco de dados para gerenciar. Tudo é armazenado em um arquivo blackboard.db local.
Patch JSON: Agentes atualizam o estado incrementalmente via JSON-RPC.
Arquivamento em Armazenamento Frio: Agentes podem arquivar subtarefas concluídas em uma tabela cold_storage para preservar os limites da janela de contexto.
Servidor MCP nativo via stdio: Totalmente compatível com o padrão MCP 2024-11-05 sobre fluxos de I/O padrão.

Instalação

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

A partir do código-fonte

cargo build --release

Início Rápido

mcp-state executa via stdio e foi projetado para ser invocado por um cliente MCP (como Claude Desktop ou Antigravity).

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

O servidor expõe as seguintes ferramentas:

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

Licença

Este projeto está licenciado sob a Apache License 2.0. Consulte os arquivos LICENSE e NOTICE para obter detalhes.