memori-mcp

An MCP (Model Context Protocol) server that exposes Memori-backed tools for IDE/agent shells like Claude Code, Cursor, and Cline.

Security-first defaults

This server is designed to follow MCP security best practices:

• Least privilege: only two tools (remember, recall) and no file-system/network side effects.
• Scoped memory: requires or derives entity_id + process_id to avoid cross-project leakage.
• Input limits: size caps and validation on all tool inputs.
• No secrets in logs: structured logs avoid dumping request payloads by default.

References:

• https://modelcontextprotocol.io/
• https://modelcontextprotocol-security.io/

Install (dev)

cd memori-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -e .

Configure

Environment variables:

• MEMORI_MCP_DB (default: sqlite:///./memori.db)
• MEMORI_MCP_ENTITY_ID (optional; default: current OS user)
• MEMORI_MCP_PROCESS_ID (optional; default: current working dir name)

Run

memori-mcp

(Transports/config vary by client. This project starts with stdio transport.)

Tools

memori.remember

Stores a memory snippet (e.g. decisions, preferences, TODOs).

memori.recall

Recalls relevant memories using semantic search.

Status

Early reference implementation.