Memory Bank MCP 服务器

<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>

一个用于远程记忆库管理的模型上下文协议 (MCP) 服务器实现，灵感来自 Cline Memory Bank。

概述

Memory Bank MCP 服务器将传统的基于文件的记忆库转换为一个集中式服务，该服务：

• 通过 MCP 协议提供对记忆库文件的远程访问
• 启用多项目记忆库管理
• 维护一致的文件结构和验证
• 确保项目记忆库之间的适当隔离

特性

• 多项目支持

  • 项目特定的目录
  • 文件结构强制执行
  • 路径遍历预防
  • 项目列表功能
  • 每个项目的文件列表

• 远程可访问性

  • 完整的 MCP 协议实现
  • 类型安全的操作
  • 正确的错误处理
  • 通过项目隔离实现安全性

• 核心操作

  • 读取/写入/更新记忆库文件
  • 列出可用项目
  • 列出项目中的文件
  • 项目存在性验证
  • 安全的只读操作

安装

安装

要通过 Smithery 为 Claude Desktop 自动安装 Memory Bank Server：

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

这将自动设置 MCP 服务器配置。 或者，您可以按照下面的“配置”部分中的描述手动配置服务器。

快速开始

1. 在您的设置中配置 MCP 服务器（请参阅下面的“配置”部分）
2. 开始在您的 AI 助手中使用记忆库工具

配置

需要在您的 Cline MCP 设置文件中配置记忆库 MCP 服务器。 位置取决于您的设置：

• 对于 Cline 扩展：~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• 对于 Claude 桌面应用程序：~/Library/Application Support/Claude/claude_desktop_config.json

将以下配置添加到您的 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"
    ]
  }
}

配置详情

• MEMORY_BANK_ROOT: 将存储项目记忆库的目录（例如，/path/to/memory-bank）
• disabled: 设置为 false 以启用服务器
• autoApprove: 不需要显式用户批准的操作列表：
  • memory_bank_read: 读取记忆库文件
  • memory_bank_write: 创建新的记忆库文件
  • memory_bank_update: 更新现有的记忆库文件
  • list_projects: 列出可用项目
  • list_project_files: 列出项目中的文件

对于 Cursor

对于 Cursor，打开设置 -> 功能 -> 添加 MCP 服务器 -> 添加以下内容：

env MEMORY_BANK_ROOT=<path-to-bank> npx -y @allpepper/memory-bank-mcp@latest

自定义 IA 指令

本节包含应粘贴到 AI 自定义指令中的指令，适用于 Cline、Claude 或 Cursor，或任何其他 MCP 客户端。 您应该复制并粘贴这些规则。 有关参考，请参阅 custom-instructions.md，其中包含这些规则。

开发

# 安装依赖
npm install

# 构建
npm run build

# 测试
npm run test

# 监听模式
npm run dev

贡献

欢迎贡献！ 请按照以下步骤操作：

1. Fork 存储库
2. 创建一个功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add amazing feature')
4. 将分支推送到远程仓库 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

开发指南

• 对所有新代码使用 TypeScript
• 在整个代码库中保持类型安全
• 为新功能添加测试
• 根据需要更新文档
• 遵循现有的代码风格和模式

测试

• 为新功能编写单元测试
• 包括多项目场景测试
• 彻底测试错误情况
• 验证类型约束
• 适当模拟文件系统操作

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

该项目实现了最初在 Cline Memory Bank 中记录的记忆库概念，并使用远程功能和多项目支持对其进行了扩展。