Memory MCP Server

Memory MCP Server

site icon
2025.03.20 3
TypeScript长期记忆存储语义搜索开发上下文管理开发效率
Memory MCP Server 是一个基于模型上下文协议(MCP)标准的长期记忆存储系统,专为大型语言模型(LLMs)设计。该系统帮助LLMs记住项目整个历史中的工作上下文,包括跨多个会话的信息。它使用语义搜索和嵌入技术来提供过去交互和开发决策的相关上下文。
View on GitHub

Overview

基本能力

产品定位

Memory MCP Server 是一个长期记忆存储系统,旨在为大型语言模型(LLMs)提供项目上下文的长期存储和检索能力。

核心功能

  • 项目基础记忆组织:按项目组织记忆内容。
  • 语义搜索:使用Ollama嵌入(nomic-embed-text模型,768维)进行语义搜索。
  • 多种记忆类型
  • 对话:对话上下文和重要讨论
  • 代码:实现细节和变更
  • 决策:关键架构和设计选择
  • 参考:外部资源和文档链接
  • 丰富的元数据存储:包括实现状态、关键决策、创建/修改的文件、代码变更、添加的依赖等。
  • 标签系统:用于记忆组织。
  • 关系跟踪:记忆条目之间的关系。

适用场景

  • 长期项目开发中的上下文记忆
  • 跨会话的代码和决策跟踪
  • 语义搜索历史对话和决策

MCP工具列表

  • Memory Management
  • store-dev-memory:创建新的开发记忆,包括内容、类型、标签、代码变更等。
  • list-dev-memories:列出现有记忆,可选标签过滤。
  • get-dev-memory:按ID检索特定记忆。
  • search:使用嵌入进行语义搜索。

常见问题解答

  • 依赖问题:确保Node.js v18或更高版本,Ollama本地运行,并安装nomic-embed-text模型。
  • 数据库问题:使用SQLite3作为数据库。

使用教程

使用依赖

  1. 安装Node.js(v18或更高版本): bash # 使用nvm安装Node.js nvm install 18 nvm use 18
  2. 安装Ollama并确保nomic-embed-text模型已安装: bash # 启动Ollama ollama serve # 安装模型 ollama pull nomic-embed-text
  3. 安装SQLite3: bash # 在Ubuntu上安装 sudo apt-get install sqlite3

安装教程

  1. 克隆仓库: bash git clone <repository-url>
  2. 安装依赖: bash npm install
  3. 构建项目: bash npm run build
  4. 创建.env文件: OLLAMA_HOST=http://localhost:11434 DB_PATH=memory.db

调试方式

  1. 启动开发模式服务器: bash npm run dev 这将:
  2. 编译TypeScript
  3. 复制schema文件
  4. 启动带自动重载的服务器
  5. 服务器通过stdio连接以兼容Cursor。

许可证

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