polypack-mcp

Un servidor MCP que expone Polypack como memoria adaptativa persistente. Las herramientas específicas de MCP viven aquí; la base de datos sigue siendo una dependencia independiente.

Ejecución

pip install -e '.[polypack]'
polypack-mcp --store ./polypack-data

El servidor expone ocho herramientas específicas: memory_store, memory_recall, memory_context, memory_feedback, memory_suppress, memory_supersede, memory_consolidate y graph_query. También publica recursos de contexto, memoria activa, esquema y estadísticas bajo polypack://.

Las herramientas de recuperación devuelven {items, metadata}. Los metadatos incluyen recuentos de candidatos y excluidos, coincidencias de contexto, componentes de puntuación, comportamiento de respaldo, la versión de recuperación y estadísticas de selección. memory_context usa tokens estimados (ceil(content characters / 4), mínimo uno) como su token_budget. Un elemento nunca se devuelve si excediera el presupuesto restante; los presupuestos menores o iguales a cero se rechazan. El contexto es una preferencia flexible: las memorias coincidentes se prefieren y las memorias globales sin ámbito pueden usarse como respaldo. Pasa strict_context: true para aislamiento. Un resultado aislado vacío informa reason: "no_context_match" y el contexto buscado.

La retroalimentación es retroalimentación de activación: useful=true refuerza una memoria y useful=false proporciona retroalimentación de recuperación negativa. Las respuestas exponen la activación antes y después, además de si los pesos aprendidos cambiaron. La supersesión y la consolidación materializan las aristas del grafo SUPERSEDES, SUPERSEDED_BY y CONSOLIDATED_FROM.

Pasa --store para abrir un directorio Polypack persistente. Sin él, el servidor usa el backend de referencia en memoria, lo que es conveniente para pruebas de humo. El extra polypack requiere polypack-db>=3.2.0 y usa su selector nativo ActivationEngine.working_memory para el ensamblado de contexto.

Related MCP server: Memory Server MCP

Desarrollo

pip install -e '.[dev]'
pytest

La suite de pruebas incluye una prueba de humo del protocolo cliente/servidor MCP que cubre el descubrimiento de herramientas, el almacenamiento de memoria, la recuperación y las lecturas de recursos.