memory-bank-mcp
installs/mo · npmstarsforks
How to install memory-bank-mcp?
alioshr/memory-bank-mcp
$git clone https://github.com/alioshr/memory-bank-mcpA Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by Cline Memory Bank.
README.md
| 1 | # Memory Bank MCP Server |
| 2 | |
| 3 | [](https://smithery.ai/server/@alioshr/memory-bank-mcp) |
| 4 | [](https://www.npmjs.com/package/@allpepper/memory-bank-mcp) |
| 5 | [](https://www.npmjs.com/package/@allpepper/memory-bank-mcp) |
| 6 | |
| 7 | <a href="https://glama.ai/mcp/servers/ir18x1tixp"><img width="380" height="200" src="https://glama.ai/mcp/servers/ir18x1tixp/badge" alt="Memory Bank Server MCP server" /></a> |
| 8 | |
| 9 | A Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by [Cline Memory Bank](https://github.com/nickbaumann98/cline_docs/blob/main/prompting/custom%20instructions%20library/cline-memory-bank.md). |
| 10 | |
| 11 | ## Overview |
| 12 | |
| 13 | The Memory Bank MCP Server transforms traditional file-based memory banks into a centralized service that: |
| 14 | |
| 15 | - Provides remote access to memory bank files via MCP protocol |
| 16 | - Enables multi-project memory bank management |
| 17 | - Maintains consistent file structure and validation |
| 18 | - Ensures proper isolation between project memory banks |
| 19 | |
| 20 | ## Features |
| 21 | |
| 22 | - **Multi-Project Support** |
| 23 | |
| 24 | - Project-specific directories |
| 25 | - File structure enforcement |
| 26 | - Path traversal prevention |
| 27 | - Project listing capabilities |
| 28 | - File listing per project |
| 29 | |
| 30 | - **Remote Accessibility** |
| 31 | |
| 32 | - Full MCP protocol implementation |
| 33 | - Type-safe operations |
| 34 | - Proper error handling |
| 35 | - Security through project isolation |
| 36 | |
| 37 | - **Core Operations** |
| 38 | - Read/write/update memory bank files |
| 39 | - List available projects |
| 40 | - List files within projects |
| 41 | - Project existence validation |
| 42 | - Safe read-only operations |
| 43 | |
| 44 | ## Installation |
| 45 | |
| 46 | To install Memory Bank Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@alioshr/memory-bank-mcp): |
| 47 | |
| 48 | ```bash |
| 49 | npx -y @smithery/cli install @alioshr/memory-bank-mcp --client claude |
| 50 | ``` |
| 51 | |
| 52 | This will set up the MCP server configuration automatically. Alternatively, you can configure the server manually as described in the Configuration section below. |
| 53 | |
| 54 | ## Quick Start |
| 55 | |
| 56 | 1. Configure the MCP server in your settings (see Configuration section below) |
| 57 | 2. Start using the memory bank tools in your AI assistant |
| 58 | |
| 59 | ## Using with Cline/Roo Code |
| 60 | |
| 61 | The memory bank MCP server needs to be configured in your Cline MCP settings file. The location depends on your setup: |
| 62 | |
| 63 | - For Cline extension: `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
| 64 | - For Roo Code VS Code extension: `~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json` |
| 65 | |
| 66 | Add the following configuration to your MCP settings: |
| 67 | |
| 68 | ```json |
| 69 | { |
| 70 | "allpepper-memory-bank": { |
| 71 | "command": "npx", |
| 72 | "args": ["-y", "@allpepper/memory-bank-mcp"], |
| 73 | "env": { |
| 74 | "MEMORY_BANK_ROOT": "<path-to-bank>" |
| 75 | }, |
| 76 | "disabled": false, |
| 77 | "autoApprove": [ |
| 78 | "memory_bank_read", |
| 79 | "memory_bank_write", |
| 80 | "memory_bank_update", |
| 81 | "list_projects", |
| 82 | "list_project_files" |
| 83 | ] |
| 84 | } |
| 85 | } |
| 86 | ``` |
| 87 | |
| 88 | ### Configuration Details |
| 89 | |
| 90 | - `MEMORY_BANK_ROOT`: Directory where project memory banks will be stored (e.g., `/path/to/memory-bank`) |
| 91 | - `disabled`: Set to `false` to enable the server |
| 92 | - `autoApprove`: List of operations that don't require explicit user approval: |
| 93 | - `memory_bank_read`: Read memory bank files |
| 94 | - `memory_bank_write`: Create new memory bank files |
| 95 | - `memory_bank_update`: Update existing memory bank files |
| 96 | - `list_projects`: List available projects |
| 97 | - `list_project_files`: List files within a project |
| 98 | |
| 99 | ## Using with Cursor |
| 100 | |
| 101 | For Cursor, open the settings -> features -> add MCP server -> add the following: |
| 102 | |
| 103 | ```shell |
| 104 | env MEMORY_BANK_ROOT=<path-to-bank> npx -y @allpepper/memory-bank-mcp@latest |
| 105 | ``` |
| 106 | ## Using with Claude |
| 107 | |
| 108 | - Claude desktop config file: `~/Library/Application Support/Claude/claude_desktop_config.json` |
| 109 | - Claude Code config file: `~/.claud |
People who liked this also viewed
6 picksType
- fastmcp🚀 The fast, Pythonic way to build MCP servers and clients.MCP ServersJul 2026
- playwright-mcpPlaywright MCP serverMCP ServersJul 2026
- ext-appsOfficial repo for spec & SDK of MCP Apps protocol - standard for UIs embedded AI chatbots, served by MCP serversMCP ServersJul 2026
- langchain-mcp-adaptersLangChain 🔌 MCPMCP ServersJul 2026
- mcporterCall MCPs via TypeScript, masquerading as simple TypeScript API. Or package them as cli.MCP ServersJul 2026
- mcp-proxyA bridge between Streamable HTTP and stdio MCP transportsMCP ServersJul 2026
