Memory Bank MCP Server

🚀 Memory Bank MCP Server Documentation

This documentation provides a comprehensive guide to installing, configuring, and using the Memory Bank MCP Server. It details the core functionalities, database structure, and usage examples, along with important notes and reference resources.

🚀 Quick Start

📦 Installation

1. Download and Install Node.js:

   • Visit the Node.js official website to download and install the latest version suitable for your operating system.

2. Install Project Dependencies:

   • Open a terminal, navigate to the project directory, and run the following command:

     npm install
     

3. Start the Server:

   • Run the following command in the project root directory:

     npm start
     

⚙️ Configuration

• Environment Variable Configuration:
  • Create a .env file and add the following content. Modify the database path as needed:

    DB_PATH=./memory-bank/memory.db
    

✨ Features

📥 Request Handling Process

1. Client Request: The client (e.g., RooCode) sends a tool invocation request to the Memory Bank MCP Server, usually including the section parameter.
2. Request Parsing: The server core receives and parses the request content.
3. Routing Logic: Determine the target database table based on the section parameter in the request.
4. Processing Logic: Execute the corresponding read/write operations.
5. Response Handling: Format the result as an MCP response and return it to the client.

🗃️ Database Structure

The core of the Memory Bank consists of the following SQLite tables, which are used to store key information of the project:

• product_context: Stores high - level information such as project background, goals, and scope.
• decisions: Records important technical choices, architectural decisions, and product direction adjustments.
• progress: Tracks development progress, status updates, and completed tasks.
• focus: Defines the current or upcoming development priorities and issues to be resolved.
• system_patterns: Records reusable patterns, common solutions, and important design principles.

💻 Usage Examples

🛠️ Tool Invocation Examples

1. Create a New Entry:

   {
     "tool": "update_memory_bank_entry",
     "args": {
       "section": "decisions",
       "entry_data": {
         "reason": "Adopt a modular architecture to improve maintainability.",
         "outcome": "Successfully implemented a modular architecture, reducing coupling."
       }
     }
   }
   

2. Query Historical Records:

   {
     "tool": "get_memory_bank_section",
     "args": {
       "section": "progress",
       "limit": 5
     }
   }
   

📊 Data Flow Diagram

graph TD
    Client["Client"] -- "Tool Invocation\n(e.g., Update Entry, section='decisions')" --> MCPServer["Memory Bank MCP Server"]
    MCPServer -- "Parse Request" --> Router{"Routing/Logic"}

    subgraph "Database Interaction"
        direction LR
        Router -- "section='product_context'?" --> Table_PC["product_context Table"]
        Router -- "section='decisions'?" --> Table_DEC["decisions Table"]
        Router -- "section='progress'?" --> Table_PROG["progress Table"]
        Router -- "section='focus'?" --> Table_FOC["focus Table"]
        Router -- "section='system_patterns'?" --> Table_SP["system_patterns Table"]

        Table_PC -- "Read/Write Operations" --> SQLiteDB["SQLite Database"]
        Table_DEC -- "Read/Write Operations" --> SQLiteDB
        Table_PROG -- "Read/Write Operations" --> SQLiteDB
        Table_FOC -- "Read/Write Operations" --> SQLiteDB
        Table_SP -- "Read/Write Operations" --> SQLiteDB
    end

    SQLiteDB -- "Operation Results" --> MCPServer
    MCPServer -- "Format Response" --> Client

⚠️ Important Note

1. Environment Variables: Ensure that the database path in the .env file is configured correctly.
2. Dependency Management: Regularly check and update project dependencies to maintain compatibility.
3. Log Monitoring: Pay attention to server logs to promptly detect and handle errors.

📚 Documentation

• Reference Documents:
  • Node.js Official Documentation
  • SQLite Official Documentation

By following the above steps and instructions, you can successfully configure and use the Memory Bank MCP Server. If you have any questions or suggestions, please contact the support team at any time.