内存库 MCP 服务器

一个用于远程内存库管理的模型上下文协议服务器执行,灵感来自 Cline 记忆库。 。 。 .

概览

记忆库 MCP 服务器将传统的基于文件的内存库转换为集中服务:

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

特征

• 多项目支助

  • 项目专有目录
  • 文件结构执行
  • 道路预防
  • 项目上市能力
  • 每个项目的文件列表

• 远程无障碍

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

• 核心业务

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

安装

自动通过 Claude 桌面安装内存库服务器 史密斯术数字 :

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 设置中添加以下配置 :

{
  "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: 列出工程内的文件

使用光标

对于光标,打开设置 - > 特性 - > 添加 MCP 服务器 - > 添加以下内容:

env MEMORY_BANK_ROOT=<path-to-bank> 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客户端. 你应该复制和粘贴这些规则。 关于参考文献,见 海关指令 包含这些规则.

发展

基本发展命令:

# 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. 构建多克图像 :

   docker build -t memory-bank-mcp:local .
   

2. 运行 Docker 容器进行测试 :

   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 代码 :

   "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. 打开拉请求

发展指导方针

• 对所有新代码使用类型脚本
• 在整个代码库维护类型安全
• 添加新特性测试
• 视需要更新文件
• 遵循现有的代码样式和模式

测试

• 新特性的写入单元测试
• 包括多项目情景测试
• 彻底测试错误大小写
• 验证类型限制
• 适当的模拟文件系统操作

许可证

这个项目根据麻省理工学院许可证颁发——见 自由主义 详细文件.

承认

该项目执行最初记录在 Cline 记忆库,以远程能力和多项目支持扩展.