Contextforge MCP

What alfredoizdev/contextforge-mcp does

alfredoizdev/contextforge-mcp gives coding assistants a persistent memory layer through the Model Context Protocol. Agents can save project knowledge, search it semantically, enumerate or remove stored items, and organize information into spaces and projects. This is suited to decisions, architecture notes, debugging findings, and other context that should remain available after a chat ends.

The server also connects project knowledge to development activity. GitHub repositories can be connected, existing history can be imported, and synchronized commits and pull requests can be listed. Its issue tools support creating, assigning, starting, resolving, and recommending work. Projects can be linked to local directories so memory operations have a project context.

How it works

The server communicates with MCP clients over the command launched by npx -y contextforge-mcp. It uses the ContextForge service at contextforge.dev and authenticates with an API key generated from that service. Semantic queries search stored knowledge by meaning rather than requiring an exact keyword match.

On connection, the server can provide startup instructions to clients that honor them. Those clients can load project memory at the beginning of a session and save relevant decisions without additional editor configuration. The init command can add explicit memory, session-presence, and startup-context rules to a project for clients that do not apply server instructions automatically.

For Claude Code projects, init can also add hooks for restoring context after conversation compaction. The generated hooks record session prompts locally and can reintroduce the session objective, relevant memories, recent project memories, and pending tasks.

Setup and configuration

Create an account at contextforge.dev, generate an API key, and expose it to the MCP process as CONTEXTFORGE_API_KEY. The key is then added to the MCP configuration for the selected client.

A typical stdio configuration uses:

{
  "command": "npx",
  "args": ["-y", "contextforge-mcp"],
  "env": {
    "CONTEXTFORGE_API_KEY": "your-api-key-here"
  }
}

The package requires Node.js 20 or newer. A global npm installation is optional; using npx fetches the package when needed. Run npx contextforge-mcp init from a project directory to generate or update editor-specific memory rules. The command can target Claude Code, Cursor, or both with its editor option.

Tools and capabilities

• Store, batch-store, search, list, and delete memory items.
• Create, list, move, link, unlink, and delete spaces and projects.
• Connect GitHub repositories, import history, synchronize changes, and inspect commits or pull requests.
• Create and manage issues, including assignment, progress, resolution, and next-task recommendations.
• Maintain project-specific context for linked directories.

Limitations and notes

Automatic startup behavior depends on whether the MCP client honors server instructions. The generated compaction-recovery hooks are specific to Claude Code. Their relevance search can be disabled with CONTEXTFORGE_RECALL_RELEVANCE=0, and recovery requires a linked project. A free tier is available through ContextForge, while service usage and account limits are governed by that platform.