MCP 内存服务器

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

以项目为中心的内存管理

此 MCP 服务器专门用于帮助 Claude 在与 Claude Desktop 一起使用时，维护项目目录中的上下文和知识。它允许 Claude：

• 在您的项目目录中创建一个内存存储
• 保存对话过程中发现的重要信息
• 在未来的会话中检索相关记忆
• 随着时间的推移，构建关于您项目的全面知识库

这种方法非常适合需要维护会话之间上下文的长期项目，例如软件开发、研究、写作或与 Claude 的任何协作工作。

特性

• 将记忆存储为结构化的 Markdown 文件
• 使用 Lunr.js 索引记忆以实现高效检索
• 标记和分类记忆
• 创建记忆之间的关系
• 按内容、标签或类型搜索记忆
• 在指定的目录中构建内存存储

内存结构

记忆以分层结构存储在您的项目中：

/your-project-directory
  /memory                # Claude 创建的内存存储
    /entities/           # 关于特定实体的信息（人物、项目等）
    /concepts/           # 抽象概念或知识
    /sessions/           # 会话特定的记忆
    /index.json          # Lunr.js 搜索索引
    /metadata.json       # 总体内存元数据
    /README.md           # 自动生成的文档

此结构使所有与项目相关的记忆在您的项目目录中保持组织性和可访问性。

与 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"
      }
    }
  }
}

项目工作流程

1. 设置：当使用 Claude 启动一个新项目时，让它在您的项目目录中创建一个内存存储
2. 持续工作：当您与 Claude 一起工作时，它会将重要信息保存到内存存储中
3. 连续性：在未来的会话中，Claude 可以检索相关记忆以保持上下文
4. 知识构建：随着时间的推移，Claude 会构建关于您项目的全面知识库

此工作流程确保 Claude 维护特定于每个项目的上下文和知识，使其作为长期合作者更有效。

Claude 项目说明

此存储库包含一个 instructions_template.md 文件，该文件为 Claude 项目说明提供了一个全面的模板。您可以为您的特定项目自定义此模板，以帮助 Claude 有效地使用内存系统。

该模板包括：

• 内存系统设置说明
• 内存检索过程
• 内存创建指南
• 内存组织系统
• 内存维护程序
• 对话工作流程
• 最佳实践

开发

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start

# 开发模式（监视更改）
npm run dev

实现细节

此服务器使用以下技术构建：

• 官方模型上下文协议 (MCP) SDK
• TypeScript 用于类型安全
• Lunr.js 用于内存索引和搜索
• Zod 用于模式验证

许可证

MIT