Memory MCP Server

一个使用模型上下文协议 (MCP) 标准的 LLM 长期记忆存储系统。该系统帮助 LLM 记住整个项目历史中所做的工作的上下文，即使跨多个会话也是如此。它使用带有嵌入的语义搜索来提供来自过去交互和开发决策的相关上下文。

特性

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

前提条件

• Node.js (v18 或更高版本)
• 本地运行的 Ollama（用于嵌入）
  • 必须安装 nomic-embed-text 模型
• SQLite3

安装

1. 克隆存储库
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 创建一个包含所需配置的 .env 文件：

   OLLAMA_HOST=http://localhost:11434
   DB_PATH=memory.db
   

用法

1. 在开发模式下启动服务器：

   npm run dev
   

   这将：

   • 编译 TypeScript
   • 复制 schema 文件
   • 启动具有自动重新加载功能的服务器

2. 服务器通过 stdio 连接以实现 Cursor 兼容性

数据库 Schema

该系统使用 SQLite，包含以下表：

核心表

• projects: 项目信息和元数据
• memories: 存储各种开发上下文的记忆条目
• embeddings: 用于语义搜索功能的向量嵌入 (768d)

组织表

• tags: 记忆组织标签
• memory_tags: 记忆和标签之间的多对多关系
• memory_relationships: 记忆条目之间的有向关系

MCP 工具

以下工具可通过 MCP 协议获得：

记忆管理

• store-dev-memory: 创建新的开发记忆，包含：
  • 内容
  • 类型（对话/代码/决策/参考）
  • 标签
  • 代码更改
  • 创建/修改的文件
  • 关键决策
  • 实现状态
• list-dev-memories: 列出具有可选标签过滤的现有记忆
• get-dev-memory: 按 ID 检索特定记忆
• search: 使用嵌入在记忆中进行语义搜索

开发

对于开发：

npm run dev

这将：

1. 杀死任何现有的服务器实例
2. 重新构建 TypeScript 代码
3. 将 schema.sql 复制到 dist 目录
4. 在开发模式下启动服务器

依赖项

关键依赖项：

• @modelcontextprotocol/sdk@^1.7.0: MCP 协议实现
• better-sqlite3@^9.4.3: SQLite 数据库接口
• node-fetch@^3.3.2: 用于 Ollama API 的 HTTP 客户端
• zod@^3.22.4: 运行时类型检查和验证

项目结构

memory-mcp-server/
├── src/
│   ├── db/
│   │   ├── init.ts     # 数据库初始化
│   │   └── service.ts  # 数据库服务层
│   ├── dev-memory.ts   # 开发记忆助手
│   ├── index.ts        # 主服务器实现
│   └── schema.sql      # 数据库 schema
├── dist/               # 编译后的 JavaScript
├── package.json        # 项目配置
└── tsconfig.json       # TypeScript 配置

贡献

欢迎贡献！请确保您：

1. 编写清晰的提交消息
2. 添加适当的文档
3. 遵循现有的代码风格
4. 根据需要添加/更新测试