Memory Bank MCP Server

基本能力

产品定位

Memory Bank MCP Server 是一个远程内存银行管理服务，旨在为 AI 助手提供集中式的内存银行管理能力。

核心功能

• 多项目支持：
• 项目特定目录
• 文件结构强制执行
• 路径遍历预防
• 项目列表功能

• 每个项目的文件列表

• 远程可访问性：

• 完整的 MCP 协议实现
• 类型安全操作
• 适当的错误处理

• 通过项目隔离实现安全性

• 核心操作：

• 读取/写入/更新内存银行文件
• 列出可用项目
• 列出项目内的文件
• 项目存在验证
• 安全的只读操作

适用场景

• AI 助手需要访问和管理多个项目的内存银行
• 需要集中式管理内存银行文件的场景
• 需要确保内存银行文件结构一致性和安全性的场景

工具列表

• memory_bank_read: 读取内存银行文件
• memory_bank_write: 创建新的内存银行文件
• memory_bank_update: 更新现有的内存银行文件
• list_projects: 列出可用项目
• list_project_files: 列出项目内的文件

常见问题解答

• 如何配置内存银行根目录？ 在配置文件中设置 MEMORY_BANK_ROOT 环境变量为内存银行存储目录。
• 如何启用服务器？ 在配置文件中将 disabled 设置为 false。
• 哪些操作不需要用户明确批准？ 在 autoApprove 列表中指定的操作。

使用教程

使用依赖

需要安装 Node.js 和 npm。

安装教程

通过 Smithery 自动安装：

npx -y @smithery/cli install @alioshr/memory-bank-mcp --client claude

手动安装： 1. 安装依赖：

npm install

1. 构建项目：

npm run build

配置

在 MCP 设置文件中添加以下配置：

{
  "allpepper-memory-bank": {
    "command": "npx",
    "args": ["-y", "@allpepper/memory-bank-mcp"],
    "env": {
      "MEMORY_BANK_ROOT": "<path-to-bank>"
    },
    "disabled": false,
    "autoApprove": [
      "memory_bank_read",
      "memory_bank_write",
      "memory_bank_update",
      "list_projects",
      "list_project_files"
    ]
  }
}

调试方式

1. 开发模式：

npm run dev

1. 运行测试：

npm run test

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。