memory-bank-mcp | 通往MCP之路

Memory Bank MCP Server

View on Smithery View on Smithery View on Smithery

Memory Bank MCP Server 是一个用于远程管理内存库的 Model Context Protocol (MCP) 服务器实现，灵感来源于 Cline Memory Bank。

概述

Memory Bank MCP Server 将传统的基于文件的内存库转变为集中式服务，具备以下功能：

通过 MCP 协议提供对内存库文件的远程访问

支持多项目内存库管理

维护一致的文件结构和验证机制

确保项目内存库之间的适当隔离

特性

多项目支持

项目专属目录
文件结构强制实施
防止路径遍历
项目列表功能
按项目列出文件

远程访问

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

核心操作

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

安装

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

这将自动设置 MCP 服务器配置。您也可以按照下方配置部分中的说明手动配置服务器。

快速开始

在设置中配置 MCP 服务器（见下方配置部分）

开始在您的 AI 助手中使用内存库工具

配置

内存库 MCP 服务器需要在您的 Cline MCP 设置文件中进行配置。具体位置取决于您的设置：

对于 Cline 扩展：~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

对于 Roo Code VS Code 扩展：~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json

对于 Claude 桌面应用：~/Library/Application Support/Claude/claude_desktop_config.json

将以下配置添加到您的 MCP 设置中：

配置详情

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 服务器 -> 添加以下内容：

自定义 AI 指令

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

开发

基本开发命令：

使用 Docker 运行

构建 Docker 镜像：

运行 Docker 容器进行测试：

添加 MCP 配置，例如 Roo Code：

贡献

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

Fork 仓库

创建功能分支 (git checkout -b feature/amazing-feature)

提交您的更改 (git commit -m '添加 amazing feature')

推送到分支 (git push origin feature/amazing-feature)

打开 Pull Request

开发指南

所有新代码使用 TypeScript

在代码库中保持类型安全

为新功能添加测试

根据需要更新文档

遵循现有的代码风格和模式

测试

为新功能编写单元测试

包括多项目场景测试

彻底测试错误情况

验证类型约束

适当模拟文件系统操作

许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

致谢

本项目实现了最初在 Cline Memory Bank 中记录的内存库概念，并通过远程功能和多项目支持对其进行了扩展。