memory_mcp

Memory MCP 服务器基于 MCP 协议，提供对知识图谱的完整管理与基于知识图谱的短故事生成功能。服务器可通过交互式、命令行参数或 JSON 配置三种方式启动，允许你通过 memory://Short-story 接口获取基于图谱的短故事，或通过实体/关系/观察等 API 进行知识图谱的增删改查。核心能力包括对多种资源类型的管理、对短故事的自动生成、以及对知识图谱的持久化保存。你可以通过 memory://short-story/all 获取所有生成的短故事，或通过 memory://short-story/{topic} 获取指定主题的故事，主题如科技、历史等。若你需要对知识图谱执行查询与修改操作，可使用 create_entities、delete_entities、search_nodes、open_nodes、create_relations、delete_relations、add_observations、delete_observations、read_graph 等 API。服务器会自动将数据以 JSON 行格式持久化到磁盘，并将最新配置写入 config.json。

Prerequisites:

• Docker 已安装并运行（推荐在大多数环境中使用容器化部署）
• 访问网络以拉取镜像 shadowcz007/memory_mcp

Installation steps:

1. 安装 Docker（若尚未安装，请根据你的系统平台安装 Docker）

2. 登录到 Docker Hub（可选，如果镜像是公开的则无需登录）

3. 拉取并运行 Memory MCP 服务器（容器化部署）

# 拉取镜像（若已在运行则跳过）
docker pull shadowcz007/memory_mcp:latest

# 以交互式日志查看方式启动容器并暴露端口（假设需要端口8080，如有自定义请调整）
docker run -it -p 8080:8080 shadowcz007/memory_mcp:latest

4. 验证启动

• 容器启动后，按照提示或通过指定的 JSON 配置接口发送请求，检查 memory_mcp 是否正常响应。
• 若需要自定义配置，请在运行时通过 JSON 配置数据进行管道传入。

Tips:

• Windows 用户请在路径中使用 \ 或 \ 以避免路径解析问题。
• 数据存储路径和 memory.json 文件将被自动创建（若不存在）。请确保运行环境对存储路径具有读写权限。
• 若使用 JSON 配置启动，请确保配置字段与文档中的接口一致，以避免启动失败。
• 如遇网络/权限问题，请检查 Docker 的网络配置以及宿主机对端口的占用情况。
• 默认端口为 8080，如需修改，请在配置中设置新的 port 值。
• 该服务器支持通过 memory://short-story/all 以及 memory://short-story/{topic} 获取短故事，主题可自定义。
• 若需自定义额外环境变量，请通过 ENV 字段注入容器环境变量（如配置路径、日志级别等）。