Magnemo

Memoria MCP local, sin dependencias, para agentes de IA: los agentes preparan, los humanos promueven, cada entrada tiene un recibo.

GitHub
2
Prueba este MCPPatrocinado

Documentación

Magnemo

Las herramientas le dieron manos a tu agente. MCP le dio un sistema nervioso. Magnemo le da un cerebro.

Memoria gobernada para agentes de IA. Cada entrada con un recibo. Tu agente escribe el borrador; nada se conserva hasta que tú digas que sí.

El único pegado

Abre tu IA (Claude Code, Cursor, Windsurf, o cualquier cosa que hable MCP) en cualquiera de tus carpetas de proyecto, y pega esto:

Set up Magnemo in this project:
1. Install it: pip install magnemo. It needs Python 3.11 or newer. If pip can't find it, install uv (curl -LsSf https://astral.sh/uv/install.sh | sh) and then run: uv tool install magnemo
2. Initialize the vault: magnemo init
3. Register the MCP server: run magnemo mount — it writes this project's MCP config itself.
4. Verify: run magnemo doctor and confirm everything passes.
5. Stage the first memory: one line on what this project is, using magnemo stage. Show me the note id.
6. Then tell me the exact command to approve it. After I approve, run magnemo bootpack and tell me what you remember — then remind me to restart you, so the memory mounts for every session after this one.
If anything fails, show me what went wrong and fix it if you can.

Sabrás que funcionó — tu IA te dirá quién es ahora.

Para constructores. Magnemo es un servidor MCP con cuatro herramientas — retrieve, stage, bootpack, handoff — y una CLI para tu lado: revisar, promover, rechazar. Se ejecuta en tu máquina, en archivos Markdown simples que tú posees, con cero llamadas de red (la línea doctor lo comprueba cada vez). Cada promoción es un clic de una persona, registrado con quién escribió la entrada, cuándo, y a través de qué puerta — memoria con un testigo. La confianza se calcula a partir de ese registro, nunca se afirma. Se monta junto a cualquier memoria que ya ejecutes (una carpeta de notas, Obsidian, una pila RAG). Python 3.11+, cero dependencias, Apache-2.0.

¿Bóveda nueva? La sección THE CHARTER dirá que aún no está promovida — eso es la gobernanza hablando: Magnemo nunca fabrica canon. Prepara una carta, revísala, promuévela, y en cada arranque posterior la servirá de vuelta textualmente. (¿magnemo no aparece tras la instalación? La carpeta de scripts de pip no está en PATH — python3 -m magnemo siempre funciona.)

Beta abierta — lee KNOWN_LIMITS.md antes de confiarle algo que no puedas perder. Advertencias honestas, sin letra pequeña.

Instalar en tu cliente

Un servidor, dicho de diez maneras. Cada bloque abajo es lo mismo: uvx magnemo-mcp con MAGNEMO_VAULT apuntando a la carpeta donde vive tu memoria (crea una con magnemo init ./vault). Probado en este Mac donde se indica; el resto proviene de la documentación de cada cliente y está marcado como no probado — las correcciones son bienvenidas, abre un issue.

Claude Code — probado.

claude mcp add magnemo -e MAGNEMO_VAULT=/absolute/path/to/vault -- uvx magnemo-mcp

(claude mcp list muestra magnemo … ✔ Connected. Añade -s project para escribirlo en el .mcp.json del repositorio para tu equipo.) ¿Solo tienes la aplicación de escritorio? claude puede no ser un comando en tu shell. En un Mac la aplicación guarda su propia copia en ~/Library/Application Support/Claude/claude-code/<version>/claude.app/Contents/MacOS/claude; ejecuta eso en lugar de claude.

Claude Desktop — probado. Descarga la extensión desde la última versión — magnemo-0.6.7.mcpb — y ábrela; Claude Desktop pide la carpeta de la bóveda y hace el resto. (El listado del directorio de conectores se añadirá una vez sea aceptado.)

Cursor — no probado aquí (no instalado en este Mac); el enlace y el bloque siguen la documentación de Cursor. Add to Cursor O ~/.cursor/mcp.json (o .cursor/mcp.json en el proyecto):

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

VS Code / Copilot — no probado aquí; según la documentación de VS Code. Install in VS Code O .vscode/mcp.json en el espacio de trabajo:

{
  "servers": {
    "magnemo": {
      "type": "stdio",
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

Windsurf — no probado; ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

Cline — no probado; Cline → MCP Servers → Configure → cline_mcp_settings.json:

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" },
      "disabled": false
    }
  }
}

Continue — no probado; ~/.continue/config.yaml (o un archivo en .continue/mcpServers/):

mcpServers:
  - name: magnemo
    command: uvx
    args: ["magnemo-mcp"]
    env:
      MAGNEMO_VAULT: /absolute/path/to/vault

Gemini CLI — no probado; ~/.gemini/settings.json:

{
  "mcpServers": {
    "magnemo": {
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

Codex CLI — no probado; ~/.codex/config.toml:

[mcp_servers.magnemo]
command = "uvx"
args = ["magnemo-mcp"]
env = { MAGNEMO_VAULT = "/absolute/path/to/vault" }

Zed — no probado; settings.json → context_servers:

{
  "context_servers": {
    "magnemo": {
      "source": "custom",
      "command": "uvx",
      "args": ["magnemo-mcp"],
      "env": { "MAGNEMO_VAULT": "/absolute/path/to/vault" }
    }
  }
}

Después de la instalación, el ciclo es el mismo en todas partes: tu agente escribe en el área de preparación, tú revisas.

magnemo yes             # promote the top of the queue (yes <id-fragment> · yes --all)
magnemo no <id> --reason "…"   # reject one — the reason is required; rejections teach
magnemo review          # the interactive queue, when you want to read first
magnemo doctor          # python, vault, config, ledger, and the mount — proves the zero-network line too

Cualquier cosa que hable MCP sobre stdio se monta de la misma manera. La puerta remota (ChatGPT y clientes alojados) está en camino en la versión 0.7.0.

Los agentes redactan, las personas conservan — la única regla

Los agentes obtienen cuatro herramientas MCP. La promoción no es una de ellas.

ActorPuertaPuede hacer
AgentesServidor MCP (stdio)retrieve memoria canónica · stage → solo área de preparación, la única herramienta de escritura · bootpack al despertar · handoff en el límite
TúCLI + git (cualquier editor)revisar la cola · promover / rechazar · editar cualquier cosa · poseer todo

La bóveda

vault/
  dev/      knowledge/ playbooks/ decisions/ debt/        ← example: a dev team's partition
  ops/      knowledge/ playbooks/ clients/ decisions/ style/  ← example: an ops team's partition
  shared/   tickets/ changelog/                            ← interop bus (gated)
  _staging/   agent writes await review here
  _index/     machine-managed
  _ledger/    trust_ledger.jsonl — append-only, never forgets

Cada nota es Markdown con frontmatter de procedencia (autor, escrito, fuente, estado, revisado_por, reemplaza, fortaleza). La procedencia es el formato del archivo.

Privacidad

Tu memoria vive en tu computadora, en archivos simples que puedes abrir. El motor no hace llamadas de red, y magnemo doctor lo comprueba cada vez que se ejecuta. La página completa: https://magnemo.ai/privacy

Garantías (Fase 1 — Recuerdo Gobernado)

  • La escritura del agente NUNCA llega directamente a los almacenes canónicos — solo área de preparación, siempre.
  • La búsqueda devuelve solo notas canónicas (aprobadas por el custodio de claves). Las afirmaciones en preparación son invisibles.
  • Los muros de partición se aplican por agente (MAGNEMO_PARTITIONS); cruzar particiones = DENEGADO.
  • La sustitución es explícita: las notas antiguas se archivan con un enlace hacia adelante. Nada se elimina.
  • Los rechazos se conservan y se registran — los rechazos enseñan.
  • Cada promover/rechazar aterriza en el Libro Mayor de Confianza de solo añadido con actor + razón.

Pruebas

python -m unittest discover -s tests -v     # incl. full MCP round-trips (legacy + four-verb)
# or: pip install -e ".[test]" && pytest

Todo lo que se ha lanzado

Versión por versión, con las notas de diseño que solían vivir aquí: CHANGELOG.md.

— Silver Valley Technologies Inc. · Fase 1 de 3 · La memoria que aprende es la memoria que se gobierna.

mcp-name: ai.magnemo/magnemo · Fuente · Seguridad · Privacidad