Memory Bank MCP With Remote SSH Support 🧠

Memory Bank MCP With Remote SSH Support 🧠

site icon
2025.04.01 3
TypeScriptAI上下文管理开发工具远程协作开发效率
Memory Bank MCP 是一个基于 Model Context Protocol (MCP) 的服务,旨在为 AI 助手提供跨会话的信息存储和检索功能。它通过管理结构化的 Memory Banks(记忆库),帮助 AI 助手在不同会话间保持上下文和跟踪进度。该服务支持本地和远程服务器存储,提供多种操作模式和工具,适用于开发、设计、调试等多种场景。
View on GitHub

Overview

基本能力

产品定位

Memory Bank MCP 是一个专为 AI 助手设计的上下文管理工具,通过结构化的 Memory Banks 存储和检索信息,支持跨会话的上下文维护和进度跟踪。

核心功能

  • Memory Bank 管理:初始化、查找和管理 Memory Banks
  • 文件操作:读写 Memory Banks 中的文件
  • 进度跟踪:记录和更新项目进度
  • 决策记录:记录重要决策及其上下文和备选方案
  • 活动上下文管理:维护和更新当前上下文信息
  • 模式支持:支持多种操作模式(如代码模式、架构模式等)
  • 远程服务器支持:通过 SSH 将 Memory Banks 存储在远程服务器上
  • 错误处理:优雅地处理错误并尽可能继续操作
  • 状态前缀系统:提供 Memory Bank 操作状态的即时可见性

适用场景

  • 开发项目:跟踪代码实现进度、记录技术决策
  • 系统设计:维护架构设计和组件信息
  • 问题调试:记录和分析问题解决过程
  • 团队协作:共享项目上下文和决策记录
  • 远程工作:将 Memory Banks 存储在中央服务器上供团队访问

工具列表

  • initialize_memory_bank:初始化 Memory Bank
  • track_progress:跟踪项目进度
  • log_decision:记录重要决策
  • switch_mode:切换操作模式
  • UMB 命令:临时更新 Memory Bank 文件

常见问题解答

  • 如何设置远程服务器? 需要 SSH 访问权限和密钥认证,具体步骤见文档
  • 如何切换模式? 可通过命令行参数、会话命令或 .clinerules 文件切换
  • Memory Bank 的结构是什么? 包含产品上下文、活动上下文、进度记录、决策日志等文件

使用教程

使用依赖

  • Node.js 环境
  • npm 或 npx
  • 远程服务器需要 SSH 访问权限

安装教程

# 从 npm 安装
npm install @aakarsh-sasi/memory-bank-mcp

# 或全局安装
npm install -g @aakarsh-sasi/memory-bank-mcp

# 或直接使用 npx(无需安装)
npx @aakarsh-sasi/memory-bank-mcp

调试方式

# 检查帮助信息
npx @aakarsh-sasi/memory-bank-mcp --help

# 测试基本功能
npx @aakarsh-sasi/memory-bank-mcp initialize_memory_bank path=./test-memory

# 测试远程连接
npx @aakarsh-sasi/memory-bank-mcp --remote --remote-user username --remote-host example.host.com --remote-path /home/username/memory-bank

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。