🚀 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
执行此命令会：
- 启动代理服务器（通常在
127.0.0.1:6277）。 - 启动基于Web的检查器界面（通常在
http://127.0.0.1:6274）。 - 提供用于身份验证的会话令牌。
使用检查器
检查器提供了多个选项卡用于测试服务器：
- 资源选项卡：查看和测试内存资源。
- 工具选项卡：测试内存管理工具（创建、更新、删除实体）。
- 提示选项卡：测试任何提示模板。
- 通知面板：监控服务器日志和消息。
开发工作流程
- 对
src/index.ts进行修改。 - 运行
npm run build进行重新构建。 - 启动检查器：
npx @modelcontextprotocol/inspector node dist/index.js。 - 在Web界面中测试更改。
- 检查通知面板是否有错误信息。
与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许可证。