MCP Memory Server

MCP Memory Server

site icon
2025.03.07 2
TypeScript结构化内存管理项目协作知识管理开发效率
MCP Memory Server 是一个专为 Claude Desktop 设计的模型上下文协议(MCP)服务器,提供跨聊天会话的结构化内存管理,特别适用于基于项目的工作。它帮助 Claude 在项目目录中维护上下文和知识,通过创建内存存储、保存重要信息、检索相关记忆以及构建项目知识库,使得 Claude 成为长期项目的有效协作伙伴。
View on GitHub

Overview

基本能力

产品定位

MCP Memory Server 是一个专为 Claude Desktop 设计的模型上下文协议(MCP)服务器,提供跨聊天会话的结构化内存管理,特别适用于基于项目的工作。

核心功能

  • 结构化内存管理:在项目目录中创建内存存储,保存和检索重要信息。
  • 高效检索:使用 Lunr.js 进行内存索引和搜索。
  • 标签和分类:支持对记忆进行标签和分类。
  • 关系建立:可以在记忆之间建立关系。
  • 目录结构:记忆以层次化结构存储在项目目录中。

适用场景

  • 软件开发:长期项目中的代码和文档管理。
  • 研究:研究资料和笔记的整理与检索。
  • 写作:写作项目的素材和草稿管理。
  • 协作工作:与 Claude 的长期协作项目。

工具列表

  • Lunr.js:用于内存索引和搜索。
  • Zod:用于模式验证。
  • TypeScript:提供类型安全。

常见问题解答

  • 如何设置自定义内存目录?:通过环境变量 MEMORY_DIR 设置。
  • 如何启动服务器?:使用 npm start 命令。

使用教程

使用依赖

确保已安装 Node.js 和 npm。

# 检查 Node.js 和 npm 是否安装
node --version
npm --version

安装教程

# 克隆项目(假设项目已克隆)
git clone <repository-url>

# 进入项目目录
cd mcp-memory

# 安装依赖
npm install

# 构建项目
npm run build

调试方式

# 启动服务器
npm start

# 开发模式(监听变化)
npm run dev

配置 Claude Desktop

claude_desktop_config.json 中添加以下配置:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["path/to/mcp-memory/dist/index.js"]
    }
  }
}

或设置自定义内存目录:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["path/to/mcp-memory/dist/index.js"],
      "env": {
        "MEMORY_DIR": "/path/to/custom/memory/directory"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款。