Proporciona memoria local compartida para agentes de programación utilizando SQLite, búsqueda semántica y entidades vinculadas para mantener el contexto del proyecto entre sesiones.
También conocido como sonic182/graphmem, @sonic182/graphmem
- Stars
- 9
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.15.2
- Último commit
- 8 nov 2026
- Licencia
- MIT
¿Qué es Graphmem MCP?
Proporciona memoria local compartida para agentes de programación utilizando SQLite, búsqueda semántica y entidades vinculadas para mantener el contexto del proyecto entre sesiones.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Graphmem
Graphmem proporciona un sistema de memoria local compartida diseñado para que los agentes de programación mantengan el contexto del proyecto a través de diferentes sesiones y herramientas. Utiliza almacenamiento SQLite y búsqueda semántica local para guardar entidades vinculadas, lo que permite que múltiples clientes MCP como Claude Code, Codex, OpenCode y pi accedan al mismo almacén de datos. Esta configuración garantiza que las decisiones tomadas durante una sesión de programación sean duraderas y accesibles más tarde.
Los usuarios pueden instalar el servidor vía npm o descargando binarios específicos para su plataforma. El sistema utiliza por defecto el repositorio Git actual para el alcance de la memoria, aunque también admite un alcance global. Los desarrolladores pueden gestionar las memorias mediante una interfaz de línea de comandos o a través de herramientas MCP. El servidor almacena todos los datos en el directorio ~/.graphmem a menos que se modifique la variable de entorno GRAPHMEM_HOME.
Más allá de la gestión de memoria, el servidor incluye herramientas opcionales de navegación de código. Estas herramientas permiten a los agentes encontrar definiciones de símbolos, listar imports de archivos, generar esquemas de código y comparar símbolos a través de diferentes revisiones de Git. Estas funciones específicas de código funcionan en checkouts de Git sin necesidad de un modelo de embeddings.
Qué puedes hacer con él
- 1Persistir decisiones del proyectoInstruye a un agente para que guarde una convención de programación específica para que sea recordada en futuras sesiones.
- 2Buscar en el contexto pasadoPide a la IA que encuentre información específica o instrucciones previas almacenadas en la memoria local.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Graphmem MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Graphmem MCP en Claude Code
$ claude mcp add graphmem -- npx -y @sonic182/graphmemInstalar Graphmem MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}Instalar Graphmem MCP en VS Code
.vscode/mcp.json
{
"servers": {
"graphmem": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}Instalar Graphmem MCP en VS Code CLI
$ code --add-mcp '{"name":"graphmem","type":"stdio","command":"npx","args":["-y","@sonic182/graphmem"]}'Instalar Graphmem MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}Instalar Graphmem MCP en Codex
$ codex mcp add graphmem -- npx -y @sonic182/graphmemInstalar Graphmem MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.graphmem] command = "npx" args = ["-y", "@sonic182/graphmem"]
Instalar Graphmem MCP en Gemini CLI
$ gemini mcp add -s user graphmem npx -- -y @sonic182/graphmemInstalar Graphmem MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblesonic182/graphmem is public and reachablegithub.com/sonic182/graphmem ↗Aprobado
- El paquete indica este repositorio como su origen@sonic182/graphmem names sonic182/graphmem as sourcenpmjs.com/package/@sonic182/graphmem ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-09github.com/sonic182/graphmem ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @sonic182/graphmemAprobado
- No hay avisos críticos en el paquete ni en sus dependencias1 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubGraphmem

Shared, local memory for coding agents. Keep project decisions across sessions and tools with SQLite storage, local semantic search, and linked entities. Claude Code, Codex, OpenCode, pi, and other MCP clients can share the same store.
Optional code tools find definitions, outline files, list imports, and compare symbols between Git revisions.
Install
npm install --global @sonic182/graphmem
gmem-install
gmem version
The npm package contains launchers. gmem-install explicitly downloads and
verifies the matching CPU binary, or reuses a working native gmem on your
PATH. Package installation itself downloads no binary. After upgrading the
package, run gmem-install again; separately installed binaries are not replaced.
MCP clients that launch servers with npx can run npx -y @sonic182/graphmem mcp.
The graphmem command downloads and verifies the binary on its first run; gmem
never downloads anything on its own.
Alternatively, download your platform's archive from
GitHub Releases, verify
it against SHA256SUMS, and put the extracted executable on your PATH.
Linux releases require glibc 2.39 and OpenSSL 3. For other systems or CUDA,
build from source.
Use it with your coding agent
Plugins include MCP registration, skills, and guidance to recall context before work and save durable decisions afterward.
| Agent | Install |
|---|---|
| Claude Code | claude plugin marketplace add sonic182/graphmem, then claude plugin install graphmem@graphmem |
| Codex | codex plugin marketplace add sonic182/graphmem, then codex plugin add graphmem@graphmem |
| OpenCode | opencode plugin @sonic182/graphmem --global |
| pi | pi install npm:@sonic182/graphmem |
Claude Code and Codex need gmem and Node.js on PATH. In Codex, trust the
Graphmem hooks in /hooks and start a new thread. Pi offers binary setup on first
startup; OpenCode prints an installer command if needed.
See plugin setup and troubleshooting.
For another MCP client, configure it to launch your installed binary:
{
"mcpServers": {
"graphmem": {
"command": "/absolute/path/to/gmem",
"args": ["mcp"]
}
}
}
CLI
gmem remember "Use nextest for integration tests" \
--type convention --scope repo:/absolute/path/to/project
gmem search "integration tests"
gmem tokens --over-limit # memories the embedding model truncates
gmem tui
gmem mcp
Memories default to the current Git repository; git must be on PATH.
Outside a repository, the default scope is global. Reads always include global
memories; explicitly select other projects with --scope (CLI) or scopes (MCP).
Writes are limited to the current repository and global, including updates and
deletions. The MCP list_scopes tool discovers scopes and their write permissions;
list pages through the memories of a selection.
Data lives in ~/.graphmem; set GRAPHMEM_HOME to use another directory.
CLI reference · MCP tool reference
Code navigation (optional)
Release binaries include these tools; source builds need --features code.
| MCP tool | Purpose |
|---|---|
find_symbol |
Find a definition and its source range |
code_outline |
List a file's definitions and nesting |
code_imports |
List declared imports |
code_diff |
Compare symbols between Git revisions |
gmem code find CodeService
gmem code outline src/application/code.rs
gmem code imports src/application/code.rs
gmem code diff origin/master
These tools work on Git checkouts without an embedding model. They index
definitions, not call sites or references; use ast-grep for those.
Set GRAPHMEM_CODE=off to disable code tools.
Options and supported languages · Benchmark results and limitations
Configuration
No config file is required. To customize embeddings, retrieval, or code indexing,
create ~/.graphmem/config.toml. See the configuration reference.
Build
See source builds and CUDA setup.
Development
just verify
Runs formatting checks, compilation, Clippy, and tests. Design · Schema evolution
To preview the documentation site, run hugo server --source site.
See site setup.
License
MIT.
Preguntas sobre Graphmem MCP
¿Cómo agrego Graphmem MCP a Claude Code?
Ejecuta claude mcp add graphmem -- npx -y @sonic182/graphmem en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Graphmem MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cómo instalo Graphmem para usarlo con un cliente MCP?
Puedes instalarlo vía npm usando npm install --global @sonic182/graphmem y luego ejecutando gmem-install, o usando npx -y @sonic182/graphmem mcp para clientes que soporten npx.
¿Dónde se almacenan los datos de la memoria?
Los datos se almacenan localmente en el directorio ~/.graphmem, aunque puedes cambiar esto configurando la variable de entorno GRAPHMEM_HOME.
¿Puedo usar Graphmem para navegar por mi código?
Sí, las herramientas de código opcionales te permiten encontrar definiciones de símbolos, esquematizar archivos, listar imports y comparar símbolos entre revisiones de Git.
¿Requiere Graphmem un archivo de configuración?
No se requiere ningún archivo de configuración por defecto, pero puedes crear ~/.graphmem/config.toml para personalizar los embeddings, la recuperación o el indexado de código.