@vitaminm/lcm-mcp
v0.0.3
Published
MCP server exposing Local Conversational Memory tools (lcm_grep, lcm_describe, lcm_expand, lcm_insert) to any MCP-compatible host.
Readme
@vitaminm/lcm-mcp
MCP server that exposes @vitaminm/lcm-core memory tools to any MCP-compatible host: Claude Code, NanoClaw v2, custom agents, etc.
Tools exposed
| Tool | Purpose |
|---|---|
| lcm_grep | Full-text search of an agent's message history via SQLite FTS5 |
| lcm_describe | Metadata for a message or summary by id |
| lcm_expand | Recover original messages covered by a summary |
| lcm_insert | Insert a new message into an agent's lcm.db |
Every tool takes an agent parameter; the server is multi-tenant and opens
each agent's lcm.db on demand. DBs live at <LCM_DB_DIR>/<agent>/lcm.db.
Install
npm install -g @vitaminm/lcm-mcp
# or run via npx (preferred for MCP host configs)Configure as MCP server
In Claude Code:
claude mcp add lcm "npx @vitaminm/lcm-mcp" --env LCM_DB_DIR=$HOME/.config/lcmIn NanoClaw v2 (per agent group):
ncl groups config add-mcp-server --group whatsapp_sage \
--name lcm --command "npx @vitaminm/lcm-mcp" --env LCM_DB_DIR=$HOME/.config/lcmConfiguration
| Env var | Default | Meaning |
|---|---|---|
| LCM_DB_DIR | ~/.config/lcm | Base directory for per-agent lcm.db files |
Smoke test
LCM_DB_DIR=$HOME/.config/lcm npx @vitaminm/lcm-mcp
# (server runs on stdio; ctrl-C to exit)To smoke-test against your existing nanoclaw v1 lcm.dbs without copying:
LCM_DB_DIR="$HOME/Library/Application Support/nanoclaw/agents" npx @vitaminm/lcm-mcp(v1 already stores DBs at <base>/<agent>/lcm.db which matches the layout
this server expects.)
