roo-code-memory-bank

The Roo Code Memory Bank MCP Server provides a file-based memory bank for maintaining project context across AI sessions. It exposes a set of MCP tools that let an agent initialize a memory store, check its status, read files, and append timestamped entries. The core tools are initialize_memory_bank, check_memory_bank_status, read_memory_bank_file, and append_memory_bank_entry. When used through an MCP client (like Cline), the server helps keep productContext.md, activeContext.md, progress.md, decisionLog.md, and systemPatterns.md up-to-date with your project details and decisions. To plan and execute tasks, you should first check whether the memory bank exists, initialize it if needed, read relevant files to load context, and then append new entries as decisions or progress occur. The server is designed to operate in a local directory where the memory-bank/ folder will be created alongside the server process, making context persistence straightforward across sessions.

Prerequisites:

• Node.js (v18 or later recommended)
• npm (comes with Node.js)
• An MCP client environment capable of launching MCP servers

Installation steps:

1. Clone the repository:

git clone https://github.com/IncomeStreamSurfer/roo-code-memory-bank-mcp-server.git
cd roo-code-memory-bank-mcp-server

2. Install dependencies:

npm install

3. Build the project (produces dist/):

npm run build

4. Run the server manually (for testing):

npm start

5. Configure your MCP client (e.g., cline) to point to the built server binary at dist/index.js with the correct Node path, as shown in the configuration example.

Tips and notes:

• The memory-bank/ directory is created in the directory from which the server process is started.
• Use check_memory_bank_status first to determine if the memory bank exists before attempting reads or appends.
• For manual testing, you can run npm start to start the server locally, and the MCP client can connect via stdio as configured.
• When configuring the MCP client, ensure you replace the path in args with the actual absolute path to dist/index.js.
• The memory bank files include productContext.md, activeContext.md, progress.md, decisionLog.md, and systemPatterns.md with initial templates upon initialization.