Skip to main content
Glama
KM-it-ops

memory-mcp

by KM-it-ops

memory-mcp — shared-brain MCP server

A local stdio MCP server over ~/.claude/memory. Exposes the LLM-Wiki brain (read / search / write) so a memory written in any agent — Claude Code, Cursor, Codex — is readable and searchable in all three. One brain, three clients, file-backed, no external service.

Tools

Tool

What it does

memory_search

Text + frontmatter ranking over name/description/tags/body (+ bucket filter, limit).

memory_read

One memory by name → frontmatter + body + resolved outbound [[wikilinks]].

memory_list

List memories (name, type, description), optional bucket filter.

memory_links

Inbound + outbound wikilink neighbours for a memory.

memory_write

Create/update a memory, regenerate MEMORY.md + hot.md, run the brain lint. A failed lint fails the write (file left for inspection).

Related MCP server: mcp-assist-memory

Architecture

  • Standalone TypeScript (ESM, strict + exactOptionalPropertyTypes), run via tsx.

  • Reads use a strict-typed parser/scanner; a corpus-parity test asserts agreement with the real brain so frontmatter never drifts.

  • Writes delegate index/hot/lint to the existing ~/.claude/tools/brain toolkit (subprocess, CLAUDE_DIR-scoped) — brain's exact logic, no source coupling.

  • Search is text + frontmatter only (no embeddings in v1).

Config

  • CLAUDE_DIR — brain root (default ~/.claude); <CLAUDE_DIR>/memory holds the buckets.

  • BRAIN_DIRtools/brain checkout (default <CLAUDE_DIR>/tools/brain).

Run

node node_modules/tsx/dist/cli.mjs src/server.ts   # stdio MCP server (stdout = MCP channel)
npm test        # vitest
npm run typecheck

Registration in Claude Code / Cursor / Codex: see register.md.

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/KM-it-ops/memory-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server