An MCP Server to store and retreive project information from memory file
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"project-mem-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Project Memory MCP An MCP server and Claude Code plugin for persistent project memory. Allows AI agents to maintain knowledge about projects between conversations via `MEMORY.md` files. ## Features - **Store & retrieve** project knowledge in Markdown format - **Incremental updates** via SEARCH/REPLACE patches - **Auto-read hook** — automatically loads project memory on first prompt (Claude Code plugin) - **Dream consolidation** — automatic project memory cleanup and deduplication (Claude Code plugin) ## Installation ### Claude Code Plugin (recommended) Installs the MCP server, auto-read hook, and dream consolidation: ```bash /plugin marketplace add /path/to/project-mem-mcp /plugin install project-mem@cc-plugin-project-mem ``` ### Standalone MCP Server For Codex, Claude Desktop, Cursor, or other MCP clients: ```bash uvx project-mem-mcp ``` #### MCP Client Configuration ```json { "mcpServers": { "project-mem-mcp": { "command": "uvx", "args": [ "project-mem-mcp", "--allowed-dir", "/path/to/your/projects" ] } } } ``` The `--allowed-dir` argument restricts which directories the server can access. Can be used multiple times. Defaults to the current working directory if omitted. ### Install from Source ```bash git clone https://github.com/pynesys/project-mem-mcp.git cd project-mem-mcp python -m venv venv source venv/bin/activate pip install -e . ``` ## Tools ### get_project_memory Retrieves `MEMORY.md` content. With no extra args, returns the whole file. The server raises `ValueError` if the file would exceed ~20K estimated tokens (below most clients' tool-result caps); use `head_only` or `offset/limit` to pull what you need. ``` get_project_memory( project_path: str, offset: int = 0, # 1-indexed start line; 0 = from start limit: int | None = None, # max lines to return head_only: bool = False, # return only size + heading TOC ) -> str ``` Typical large-file pattern: call once…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.