gmem

Name: gmem
Author: yksanjo

@yksanjo

About gmem

Persistent typed memory MCP server for Solana programs and EVM contracts. Agents remember Programs, PDAs, Contracts, Decisions, Findings across sessions.

#solana #evm #anchor #hardhat #memory #agent #claude-code #developer-tools

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gmem": {
      "command": "npx",
      "args": [
        "-y",
        "@yksanjo/gmem"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is gmem?

gmem is an MCP server that gives AI coding agents (Claude Code, Cursor, Cline, Continue.dev) persistent, typed project memory for blockchain development. It stores entities like Solana programs, EVM contracts, PDAs, accounts, architectural decisions, audit findings, and integrations in an append-only SQLite database, so context is never lost between sessions.

How to use gmem?

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.

Key features of gmem

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

Use cases of gmem

Preserve project context for AI agents working on Solana or EVM smart contracts across sessions
Track architectural decisions, audit findings, and rationale alongside code
Automatically ingest workspace metadata (IDLs, ABIs, Anchor versions) into memory
Maintain a shared, typed project memory for teams using AI coding tools

FAQ from gmem

How do I install gmem?

Use npm install -g @yksanjo/gmem for a global install, or add the npx -y @yksanjo/gmem command to your MCP client configuration.

What entities does gmem support?

gmem defines first-class entity types: Program, Contract, PDA, Account, Decision, Finding, and Integration. Each has typed fields relevant to on-chain development.

How does gmem store memory?

Memory is stored in a local SQLite database with FTS5 full-text search and BM25 ranking. Each project gets its own database, and all writes are append-only to preserve history.