MCP Memory Server

🚀 MCP内存服务器

本项目是一个模型上下文协议（Model Context Protocol，MCP）服务器的实现，为大语言模型提供持久化内存功能，助力模型在不同对话和会话中更好地存储、检索和推理信息。

🚀 快速开始

本仓库包含 模型上下文协议 内存服务器的参考实现。该服务器基于知识图谱构建了持久化内存系统，使大语言模型能够在不同对话和会话中存储、检索信息并进行推理。

✨ 主要特性

• 知识图谱存储：基于图结构实现信息的持久化存储。
• 实体管理：创建和管理实体及其关系。
• 语义搜索：利用语义相似度查找相关信息。
• 跨会话记忆：在不同对话间保持上下文连贯性。
• 内存操作：支持完整的CRUD操作，方便进行内存管理。

📦 安装指南

npm install
npm run build

💻 使用示例

基础用法

运行内存服务器：

npx mcp-server-memory

开发模式

npm run watch

此命令会以开发模式启动服务器，当文件发生更改时会自动重新构建。

直接执行

在开发和测试阶段，可直接运行服务器：

# 若尚未构建，先进行构建
npm run build

# 运行服务器
node dist/index.js

使用npm二进制文件

构建完成后，可使用npm二进制文件名来运行服务器：

npx mcp-server-memory

作为后台进程

服务器会持续运行，并通过标准输入输出（stdio）进行通信，这也是MCP服务器的标准通信方式。

📚 详细文档

使用MCP检查器进行测试

MCP检查器 是开发过程中测试和调试内存服务器的优秀工具：

启动检查器

npx @modelcontextprotocol/inspector node dist/index.js

执行此命令会：

1. 启动代理服务器（通常在 127.0.0.1:6277）。
2. 启动基于Web的检查器界面（通常在 http://127.0.0.1:6274）。
3. 提供用于身份验证的会话令牌。

使用检查器

检查器提供了多个选项卡用于测试服务器：

• 资源选项卡：查看和测试内存资源。
• 工具选项卡：测试内存管理工具（创建、更新、删除实体）。
• 提示选项卡：测试任何提示模板。
• 通知面板：监控服务器日志和消息。

开发工作流程

1. 对 src/index.ts 进行修改。
2. 运行 npm run build 进行重新构建。
3. 启动检查器：npx @modelcontextprotocol/inspector node dist/index.js。
4. 在Web界面中测试更改。
5. 检查通知面板是否有错误信息。

与MCP客户端集成

要将此服务器与MCP客户端（如Claude Desktop）配合使用，需将其添加到客户端配置中：

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

若已发布到npm，可使用以下配置：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-memory"]
    }
  }
}

模型上下文协议

模型上下文协议（MCP）是一个开放标准，旨在实现AI应用程序与外部数据源和工具的无缝集成。欲了解更多信息，请访问 modelcontextprotocol.io。

📄 许可证

本项目采用MIT许可证。