# @allpepper/memory-bank-mcp 中文文档 规范地址：https://npmcn.com/package/%40allpepper/memory-bank-mcp/ 版本：0\.2\.2 npm 元数据更新时间：2026-01-09T11:59:18.777Z 中文译文更新时间：2026-11-06T15:31:34.813Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40allpepper/memory-bank-mcp 原文对照：https://npmcn.com/package/%40allpepper/memory-bank-mcp/?lang=original 项目主页：https://github.com/alioshr/memory-bank-mcp#readme 源码仓库：https://github.com/alioshr/memory-bank-mcp ## 关键信息（来自 npm 元数据） - 包体积（解压后）：55.8 kB，90 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - 运行依赖：2 个 - 首次发布：2025-02-22T23:56:16.622Z - 最新版本发布：2026-01-09T11:59:18.590Z - 近 30 天下载量：2903（2026-10-06 至 2026-11-04，npm 官方下载统计） - 已发布版本数：11（近 12 个月 1 个） ## 中文简介 MCP 远程管理项目存储库的服务器 ## 安装 ```sh npm install @allpepper/memory-bank-mcp ``` 也可以使用：`pnpm add @allpepper/memory-bank-mcp`、`yarn add @allpepper/memory-bank-mcp`、`bun add @allpepper/memory-bank-mcp` ## README # 内存库 MCP 服务器 [![smithery badge](https://smithery.ai/badge/@alioshr/memory-bank-mcp)](https://smithery.ai/server/@alioshr/memory-bank-mcp) [![npm version](https://badge.fury.io/js/%40allpepper%2Fmemory-bank-mcp.svg)](https://www.npmjs.com/package/@allpepper/memory-bank-mcp) [![npm downloads](https://img.shields.io/npm/dm/@allpepper/memory-bank-mcp.svg)](https://www.npmjs.com/package/@allpepper/memory-bank-mcp) [![Memory Bank Server MCP server](https://glama.ai/mcp/servers/ir18x1tixp/badge)](https://glama.ai/mcp/servers/ir18x1tixp) 一个用于远程内存库管理的模型上下文协议服务器执行,灵感来自 [Cline 记忆库](https://github.com/nickbaumann98/cline_docs/blob/main/prompting/custom%20instructions%20library/cline-memory-bank.md)。 。 。 . ## 概览 记忆库 MCP 服务器将传统的基于文件的内存库转换为集中服务: - 通过 MCP 协议远程访问内存库文件 - 启用多项目存储库管理 - 维持一致的文件结构和验证 - 确保项目记忆库之间的适当隔离 ## 特征 - **多项目支助** - 项目专有目录 - 文件结构执行 - 道路预防 - 项目上市能力 - 每个项目的文件列表 - **远程无障碍** - MCP协议的全面执行 - 类型安全操作 - 正确处理错误 - 通过项目隔离实现安全 - **核心业务** - 读取/写入/更新存储库文件 - 列出可用的项目 - 列出项目内的文件 - 项目存在验证 - 安全只读操作 ## 安装 自动通过 Claude 桌面安装内存库服务器 [史密斯术](https://smithery.ai/server/@alioshr/memory-bank-mcp)数字 : ```bash npx -y @smithery/cli install @alioshr/memory-bank-mcp --client claude ``` 这将自动设置 MCP 服务器配置 。 或者,您可以按下面配置一节中描述的手动配置服务器 . ## 快速启动 1. 在您的设置中配置 MCP 服务器( 见下文配置部分) 2. 开始使用您的 AI 助手中的存储库工具 ## 使用 Cline/ Roo 代码 存储库 MCP 服务器需要在您的 Cline MCP 设置文件中配置 。 位置取决于您的设置 : - Cline 扩展名 : `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` - 对于 Roo 代码 VS 代码扩展: `~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json` 在您的 MCP 设置中添加以下配置 : ```json { "allpepper-memory-bank": { "command": "npx", "args": ["-y", "@allpepper/memory-bank-mcp"], "env": { "MEMORY_BANK_ROOT": "" }, "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`: 列出工程内的文件 ## 使用光标 对于光标,打开设置 - > 特性 - > 添加 MCP 服务器 - > 添加以下内容: ```shell env MEMORY_BANK_ROOT= npx -y @allpepper/memory-bank-mcp@latest ``` ## 与克劳德一起使用 - Claude 桌面配置文件 : `~/Library/Application Support/Claude/claude_desktop_config.json` - Claude 代码配置文件 : `~/.claude.json` 1. 定位配置文件 2. 找到所谓的财产 `mcpServers` 3. 粘贴此 : ``` "allPepper-memory-bank": { "type": "stdio", "command": "npx", "args": [ "-y", "@allpepper/memory-bank-mcp@latest" ], "env": { "MEMORY_BANK_ROOT": "YOUR PATH" } } ``` ## 自定义 AI 指令 本节包含应在AI自定义指令上粘贴的指令,无论是Cline,Claude还是Cursor,还是任何其他MCP客户端. 你应该复制和粘贴这些规则。 关于参考文献,见 [海关指令](https://npmcn.com/package/%40allpepper/memory-bank-mcp/custom-instructions.md) 包含这些规则. ## 发展 基本发展命令: ```bash # Install dependencies npm install # Build the project npm run build # Run tests npm run test # Run tests in watch mode npm run test:watch # Run the server directly with ts-node for quick testing npm run dev ``` ### 和多克一起运行 1. 构建多克图像 : ```bash docker build -t memory-bank-mcp:local . ``` 2. 运行 Docker 容器进行测试 : ```bash docker run -i --rm \ -e MEMORY_BANK_ROOT="/mnt/memory_bank" \ -v /path/to/memory-bank:/mnt/memory_bank \ --entrypoint /bin/sh \ memory-bank-mcp:local \ -c "ls -la /mnt/memory_bank" ``` 3. 添加 MCP 配置, 例如 Roo 代码 : ```json "allpepper-memory-bank": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MEMORY_BANK_ROOT", "-v", "/path/to/memory-bank:/mnt/memory_bank", "memory-bank-mcp:local" ], "env": { "MEMORY_BANK_ROOT": "/mnt/memory_bank" }, "disabled": false, "alwaysAllow": [ "list_projects", "list_project_files", "memory_bank_read", "memory_bank_update", "memory_bank_write" ] } ``` ## 捐款 欢迎捐款! 请遵循这些步骤: 1. 叉子存储器 2. 创建特性分支( E)`git checkout -b feature/amazing-feature`(中文(简体) ) 3. 提交更改( E)`git commit -m 'Add amazing feature'`(中文(简体) ) 4. 推向分行(`git push origin feature/amazing-feature`(中文(简体) ) 5. 打开拉请求 ### 发展指导方针 - 对所有新代码使用类型脚本 - 在整个代码库维护类型安全 - 添加新特性测试 - 视需要更新文件 - 遵循现有的代码样式和模式 ### 测试 - 新特性的写入单元测试 - 包括多项目情景测试 - 彻底测试错误大小写 - 验证类型限制 - 适当的模拟文件系统操作 ## 许可证 这个项目根据麻省理工学院许可证颁发——见 [自由主义](https://npmcn.com/package/%40allpepper/memory-bank-mcp/LICENSE) 详细文件. ## 承认 该项目执行最初记录在 [Cline 记忆库](https://github.com/nickbaumann98/cline_docs/blob/main/prompting/custom%20instructions%20library/cline-memory-bank.md),以远程能力和多项目支持扩展. ## 常见问题 ### @allpepper/memory-bank-mcp 是什么？ MCP 远程管理项目存储库的服务器 ### 如何安装 @allpepper/memory-bank-mcp？ 在项目目录运行 npm install @allpepper/memory-bank-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-server-memory-bank，可以用 npx mcp-server-memory-bank 直接运行。 ### @allpepper/memory-bank-mcp 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/allpepper\_\_memory-bank-mcp 是否存在。 ### @allpepper/memory-bank-mcp 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @allpepper/memory-bank-mcp 可以商用吗？ @allpepper/memory-bank-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @allpepper/memory-bank-mcp 的下载量有多少？ 根据 npm 官方下载统计，@allpepper/memory-bank-mcp 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,903 次，日均约 97 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @allpepper/memory-bank-mcp 还在维护吗？ 最新版本 0\.2\.2 发布于 2026/01/09（9 个月前）；至今共发布 11 个版本，其中过去 12 个月发布了 1 个；首次发布于 2025/02/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。