内存银行MCP
提供了一个基于集中式MCP的系统，用于远程管理和访问多项目内存库，具有项目隔离、文件结构验证和类型安全操作等功能。
可用工具 （5 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
memory_bank_read 2 个参数 需填 2 项
Read a memory bank file for a specific project
必填参数：projectName、fileName
memory_bank_write 3 个参数 需填 3 项
Create a new memory bank file for a specific project
必填参数：projectName、fileName、content
memory_bank_update 3 个参数 需填 3 项
Update an existing memory bank file for a specific project
必填参数：projectName、fileName、content
list_projects
List all projects in the memory bank
该工具无需必填参数，直接调用即可
list_project_files 1 个参数 需填 1 项
List all files within a specific project
必填参数：projectName
服务介绍
Memory Bank MCP 服务器
这是一个用于远程管理内存库的模型上下文协议 (MCP) 服务器实现，灵感来源于 Cline 内存库。
概览
Memory Bank MCP 服务器将传统的基于文件的内存库转换为一个集中式服务，它能够：
- 通过 MCP 协议提供对内存库文件的远程访问
- 支持多项目内存库管理
- 维护一致的文件结构和验证
- 确保项目之间内存库的适当隔离
功能
-
多项目支持
- 项目特定目录
- 强制执行文件结构
- 防止路径遍历
- 项目列表功能
- 项目内文件列表
-
远程访问能力
- 完整的 MCP 协议实现
- 类型安全的操作
- 适当的错误处理
- 通过项目隔离确保安全性
-
核心操作
- 读取/写入/更新内存库文件
- 列出可用项目
- 列出项目内的文件
- 项目存在性验证
- 安全的只读操作
安装
安装
要通过 Smithery 自动安装适用于 Claude Desktop 的 Memory Bank 服务器，请运行以下命令：
npx -y @smithery/cli install @alioshr/memory-bank-mcp --client claude
这将自动设置 MCP 服务器配置。或者，您也可以按照下面的配置部分手动进行配置。
快速开始
- 在您的设置中配置 MCP 服务器（参见下面的配置部分）
- 开始在您的 AI 助手中使用内存库工具
配置
内存库 MCP 服务器需要在您的 Cline 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，其中包含了这些规则。
开发
# Install dependencies
npm install
# Build
npm run build
# Test
npm run test
# Watch mode
npm run dev
贡献
欢迎贡献！请遵循以下步骤：
- Fork 仓库
- 创建一个功能分支 (
git checkout -b feature/amazing-feature) - 提交你的更改 (
git commit -m 'Add amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 打开一个 Pull Request
开发指南
- 对所有新代码使用 TypeScript
- 在整个代码库中保持类型安全
- 为新功能添加测试
- 根据需要更新文档
- 遵循现有的代码风格和模式
测试
- 为新功能编写单元测试
- 包括多项目场景测试
- 彻底测试错误情况
- 验证类型约束
- 适当模拟文件系统操作
许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。
致谢
本项目实现了最初在 Cline Memory Bank 中记录的记忆库概念，并扩展了远程功能和支持多项目。
