pmll-memory-mcp — MCP server for agent memory
An MCP server that gives coding agents a durable context store and keeps repeated work out of the loop through Q-promise.
claude mcp add pmll-memory-mcp -- npx -y pmll-memory-mcpWhat pmll-memory-mcp does
The server exposes long-lived key-content storage for an agent session. Two layers sit inside: PMLL owns state and answers lookups either by exact key or by meaning, while the Q-promise library tracks deferred promises and their continuations. A resolved promise can be written back into the same store, so the fetch, compute, save sequence survives across steps.
Semantic lookup comes from cosine similarity over stored embeddings of dimension 32. peek handles the exact-match case. That matters when an agent picks a task back up after a break or needs to avoid redoing a step it already finished.
You do not have to touch the C layer. The package runs through npx, so Node is required on the machine. Promise draining is single-threaded: continuations fire only inside qpromise_drain() on the calling thread, which means callers serialize access themselves.
What it helps with
- carry a task's context across agent sessions
- locate a memory entry by meaning instead of an exact key
- skip work that a previous run already completed
- tie a deferred result back to its memory key
- write updated state into the store after a promise resolves
Example prompts for the agent
- Store the current refactor plan under the key
task-42 - Look through memory for anything tied to the schema migration
- Resolve the pending promise and commit the outcome to the store
How to install pmll-memory-mcp
Platform CLI
claude mcp add pmll-memory-mcp -- npx -y pmll-memory-mcpPlatform CLI
codex mcp add pmll-memory-mcp -- npx -y pmll-memory-mcpConfig file
{
"mcpServers": {
"pmll-memory-mcp": {
"command": "npx",
"args": [
"-y",
"pmll-memory-mcp"
]
}
}
}Config file
{
"servers": {
"pmll-memory-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"pmll-memory-mcp"
]
}
}
}Platform CLI
gemini mcp add pmll-memory-mcp npx -y pmll-memory-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about pmll-memory-mcp
How do I install pmll-memory-mcp in Claude Code?
Run claude mcp add pmll-memory-mcp -- npx -y pmll-memory-mcp. It launches the server through npx and registers it as pmll-memory-mcp.
What does pmll-memory-mcp do?
It keeps a durable memory for the agent and retrieves entries by exact key or by semantic similarity. A separate promise library handles deferred work whose results can be committed back to that store.
Can several threads use the server at once?
Continuations run only during qpromise_drain() on the calling thread, so you serialize access on your side.
