gmem
About
Persistent typed memory MCP server for Solana programs and EVM contracts. Agents remember Programs, PDAs, Contracts, Decisions, Findings across sessions.
Details
- Author
- yksanjo
- Downloads
- 367
- Categories
- Other, AI, Developer Tools
Jump to
- Auto-ingest Anchor and Hardhat workspaces
- SQLite with FTS5 BM25 ranking for semantic recall
- Append-only versioning – history is never overwritten
- One SQLite database per project – no cross-project leakage
- 7 MCP tools for read/write/query/ingest workflows
- MIT-licensed, single binary via npm
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
gmemCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install gmem globally via npm (npm install -g @yksanjo/gmem) or add it to your MCP client configuration by specifying npx -y @yksanjo/gmem as the command. It exposes 7 read/write/query/ingest MCP tools. To auto-ingest an existing project, use the gmem.ingest_anchor (for Anchor workspaces) or gmem.ingest_hardhat (for Hardhat workspaces, v1.1+) tool.
gmem.recall
Retrieve memory entries relevant to a natural-language query for the active Solana project. Ranked by BM25 over entity fields with a recency boost.
gmem.write
Persist a typed memory entry (Program / Account / Instruction / Decision / Finding / Integration). Append-only: re-writing the same logical entity creates a new version, never overwrites.
gmem.diff
Show how memory state changed between two points in time. Accepts ISO 8601 timestamps OR git commit refs (HEAD, HEAD~3, branch names, full or short SHAs) — refs are resolved via `git show -s --format=%cI` in the active project root. v0.5 milestone.
gmem.list_decisions
List all Decision entries for the active project, newest first.
gmem.ingest_anchor
Auto-ingest an Anchor workspace: parses `Anchor.toml`, captures the IDL SHA-256 for each program from `target/idl/<name>.json`, and records the current git HEAD as the source commit. Writes one Program entity per (program, cluster) pair. v0.3 milestone.
gmem.solana_context
Read the active Solana CLI context (`~/.config/solana/cli/config.yml`) and return the configured cluster, RPC URL, and the public address of the active keypair. Used to auto-attribute Decision writes to a developer wallet. v0.4 milestone. Does not return the secret key.
gmem.ingest_hardhat
Auto-ingest a Hardhat (EVM) workspace: walks up to the nearest hardhat.config.{ts,js,cjs,mjs}, reads every deployment artifact under deployments/<network>/<Contract>.json (hardhat-deploy convention), classifies the network into a canonical chain id, computes a stable ABI sha256, records git HEAD as sourceCommit. Writes one Contract entity per (chain, address). v1.1 milestone. Companion to gmem.ingest_anchor for Solana.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"gmem": {
"gmem": {
"command": "npx",
"args": [
"-y",
"@yksanjo/gmem"
]
}
}
}
}McpServers
{
"gmem": {
"command": "npx",
"args": [
"-y",
"@yksanjo/gmem"
]
}
}What gmem solves
AI coding agents (Claude Code, Cursor, Cline, Continue.dev) lose all project context between sessions. Every morning you re-paste program addresses, re-explain why Pyth vs Chainlink, re-pin Anchor versions, re-walk the agent through last week's audit findings. gmem fixes this with typed project memory — first-class entities for the things that matter on-chain.Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
