memory_mcp

🚀 内存 MCP 服务器

本服务器是基于 MCP Servers - memory 改造的知识图谱管理服务器，具备多种启动方式和完整的知识图谱管理功能，能为用户提供灵活、便捷的知识图谱管理体验。

✨ 主要特性

• 多种启动方式：支持交互式、命令行、JSON 配置三种启动方式，满足不同用户的使用习惯。
• 短故事生成（实验）：可生成符合知识图谱背景的短故事，具体可查看 mcp_client.py 中的 handle_sampling_message 函数。
• 完整管理功能：具备完整的知识图谱管理功能，涵盖实体、关系、观察和图谱等操作。
• MCP 协议支持：支持 MCP 协议的 tools、resource、sampling 功能。
• 数据持久化：自动进行数据持久化，确保数据的安全性和可恢复性。
• 灵活配置选项：提供灵活的配置选项，方便用户根据实际需求进行调整。

🚀 快速开始

启动方式

1. 交互式启动：直接运行程序（双击），按提示输入配置：
   • 程序会提示输入端口号（默认 8080）。
   • 程序会提示输入内存文件路径（默认为程序所在目录的 memory.json）。
2. 命令行传参：启动服务

mcp_server_memory.exe --port 8080 --memory-path ./memory.json

3. JSON 配置启动：通过管道传入 JSON 配置：

echo '{"jsonrpc": "2.0","method": "start","id": 2,"params":{"port": 8080, "memory_path": "./memory.json"}}' | ./mcp_server_memory.exe

获取帮助信息

echo '{"jsonrpc": "2.0","method": "help","id": 1}' | mcp_server_memory.exe

📦 安装指南

本部分文档未提及具体安装步骤，若有相关需求，请参考相关链接中的使用教程。

📚 详细文档

配置项

| 参数 | 说明 | 默认值 | |--------------|--------------------------|------------------| | port | 服务器监听端口 | 8080 | | memory_path | 数据存储文件路径 | ./memory.json |

API 接口

实体操作

• create_entities：创建实体
• delete_entities：删除实体
• search_nodes：搜索节点
• open_nodes：打开指定节点

关系操作

• create_relations：创建关系
• delete_relations：删除关系

观察操作

• add_observations：添加观察
• delete_observations：删除观察

图谱操作

• read_graph：读取完整图谱

Resource 接口

• memory://short-story/all：获取所有基于知识图谱生成的短故事
• memory://short-story/{topic}：获取指定主题的短故事
  • topic：故事主题关键词，例如 "科技"、"历史" 等

数据持久化

• 数据以 JSON 行格式存储。
• 自动保存最新配置到 config.json。
• 支持相对/绝对路径。
• 自动创建不存在的目录。

⚠️ 注意事项

⚠️ 重要提示

• Windows 系统推荐使用 \ 或 \\ 作为路径分隔符。
• 确保程序对存储路径有读写权限。
• 首次运行自动创建存储文件。

🔗 相关链接

• GitHub 仓库
• 使用教程