Promem-MCP

Project Memory MCP — contexto de proyecto persistente para agentes de codificación de IA. Creado por DIP-RO.

pip install promem-mcp

Sin base de datos. Sin nube. Sin demonio. Sin gestión manual de memoria.

ContextMCP es un runtime de contexto nativo de MCP, local-first, que brinda a los agentes de codificación de IA una comprensión persistente del proyecto — arquitectura, reglas, decisiones, convenciones, inteligencia del entorno y contexto de Git — sin necesidad de explicaciones repetidas ni desperdicio de contexto.

Inicio rápido

pip install promem-mcp

Luego, registra ContextMCP con tu cliente de codificación de IA:

# See which clients are detected
promem config

# Auto-configure a specific client (with backup + merge)
promem config cursor
promem config claude-code
promem config claude-desktop
promem config vscode

O agrégalo manualmente a la configuración MCP de tu cliente:

{
  "mcpServers": {
    "contextmcp": {
      "command": "contextmcp",
      "args": []
    }
  }
}

Nota para VS Code: VS Code usa la clave "servers", no "mcpServers". Ejecuta promem config vscode para obtener el formato correcto.

Eso es todo. Tu agente de codificación de IA ahora tiene contexto de proyecto persistente.

Cómo funciona

Funcionalidades

• Almacenamiento sin configuración — Base de datos SQLite creada automáticamente en el directorio apropiado del sistema operativo

• Detección automática de proyectos — lenguaje, framework, gestor de paquetes, framework de pruebas

• Memoria persistente — reglas, decisiones, convenciones, hechos del entorno, inteligencia de Git

• Recuperación eficiente de tokens — búsqueda FTS5 con presupuesto de tokens, devuelve solo contexto relevante

• Seguimiento de procedencia — cada recuerdo sabe de dónde vino y su nivel de confianza

• Redacción de secretos — claves API, tokens, contraseñas nunca se almacenan ni devuelven

• Aislamiento de proyectos — los recuerdos de proyectos nunca se filtran entre proyectos

• Detección de contexto obsoleto — marca recuerdos que entran en conflicto con el estado actual del proyecto

• Detección de contradicciones — identifica reglas del proyecto en conflicto

• Continuidad de sesión — resúmenes de traspaso para cambiar entre agentes/sesiones

• Inteligencia de Git — commits recientes, archivos modificados, TODOs/FIXMEs

• Diagnósticos del entorno — versión de Python, venv, integridad de .env, Docker

• Local-first — sin solicitudes de red, sin nube, sin servicios externos

Herramientas MCP

CLI

contextmcp --version        # Version
promem status           # Project + storage status
promem doctor           # Health checks
promem stats            # Usage statistics
promem search "query"   # Search context
promem memory list      # List memories
promem decision "text"  # Save a decision
promem privacy          # Privacy info
promem config           # Client configuration
promem repair           # Rebuild index, optimize DB
promem reset            # Delete all data (with confirmation)

Compatibilidad con clientes

Ningún cliente admite el registro automático sin configuración real. ContextMCP detecta los clientes instalados, ofrece escribir la configuración (con respaldo + fusión), y proporciona fragmentos exactos para copiar y pegar.

Privacidad

• Solo local — sin solicitudes de red

• Los contenidos del proyecto no se suben

• Secretos redactados — nunca se almacenan ni devuelven

• Sin dependencias en la nube

promem privacy

Ubicación de almacenamiento

ContextMCP utiliza almacenamiento local del proyecto — sin directorio OS centralizado, sin espacio desperdiciado.

Cada proyecto obtiene su propio .contextmcp/contextmcp.db. El almacenamiento viaja con el proyecto. Sin inflación de almacenamiento global.

Agrega .contextmcp/ a tu .gitignore (ya incluido por defecto en los patrones de ignorar de ContextMCP).

Anula con la variable de entorno CONTEXTMCP_DATA_DIR si es necesario.

Instalación

# pip
pip install promem-mcp

# uv
uv add contextmcp

# pipx (global CLI)
pipx install contextmcp

Funciona en venv, virtualenv, uv, pipx y Python del sistema.

Desarrollo

git clone https://github.com/contextmcp/contextmcp.git
cd contextmcp
pip install -e ".[dev]"
pytest

Licencia

MIT