cline -memory-bank

The Cline Memory Bank MCP server provides a persistent project context for AI-assisted development. It stores and manages project context, session state, progress milestones, and a log of technical decisions to help your AI assistant stay aligned across sessions. After you initialize the memory bank for a project, you can invoke tools like initialize_memory_bank, update_context, record_decision, and track_progress to build and maintain a structured memory of intent, tasks, and decisions. The memory endpoints are exposed through the memory-bank MCP, and can be triggered via the Cline extension or direct MCP tool calls when integrated into your workflow.

Prerequisites:

• Node.js v16 or later
• pnpm (recommended for dependency management)
• TypeScript tooling if you plan to contribute or develop locally

Setup steps:

1. Clone the repository git clone https://github.com/dazeb/cline-mcp-memory-bank cd cline-mcp-memory-bank

2. Install dependencies (using pnpm as recommended) pnpm install

3. Build the server pnpm run build

4. Initialize the memory bank for a project (example) node build/index.js initialize_memory_bank .

5. Configure Cline to load the MCP server (example settings snippet inside your Cline config): { "mcpServers": { "memory-bank": { "command": "node", "args": [ "/path/to/cline-memory-bank/build/index.js" ], "disabled": false, "autoApprove": [] } } }

Replace /path/to/cline-memory-bank with the absolute path to your cloned and built server. The initialization command above can also be run automatically by the Cline workflow after building.

Tips and considerations:

• Ensure Node.js v16+ is installed and available in your PATH.
• The memory-bank server stores project context in Markdown files and structured JSON; ensure the process has write access to the project directory.
• If you use the manual Cline settings method, ensure the path matches your OS-specific configuration and that the settings file is accessible by your Cline extension.
• The following MCP tool calls are available after initialization:
  • initialize_memory_bank: create the memory structure for a new project
  • update_context: refresh the current session context with mode, tasks, and session state
  • record_decision: log architectural decisions with rationale
  • track_progress: update milestones and task statuses
• Environment variables you may encounter include PATH for Node, and any project-specific data paths used by the server. You can add a .env or equivalent environment config if you extend the server.
• If you see permissions errors, verify that the process running the MCP server has read/write access to the project directory and the build/index.js path.