使用说明内容（Markdown格式）

Memory Knowledge Graph MCP 服务器 使用说明

• 项目简介

  • 这是一个以 MCP 为核心的后端服务器实现，面向 LLM 客户端提供资源托管、工具注册与执行、以及提示模板渲染等能力。服务器内部实现了知识图谱的多项目隔离、会话管理、增量同步、以及基于令牌成本的图谱自我管理（压缩、存档、备份等）。

• 主要功能点

  • MCP 核心能力：通过工具接口注册与执行，响应客户端的资源读取、边/节点操作、以及同步请求。
  • 资源与边的多项目图谱：支持“用户级别”全局图谱与“项目级别”按会话挂载的图谱。
  • 会话管理与同步：为每个会话注册、追踪起始时间、维护会话有效性，并提供跨会话的差异同步。
  • 实时通知与广播：通过 WebSocket/流式传输将变更通知客户端，支持按项目广播和全量广播。
  • 数据持久化与备份：实现原子写入、分级备份（最近备份、每日备份、每周备份）及曲线化回收策略（存档/清理孤儿节点）。
  • REST API 及可视化接口：提供健康检查、图谱读取、会话注册、节点/边的增删改等 REST 端点，便于可视化编辑与运维。

• 安装步骤

  • 获取代码：克隆或下载仓库。
  • 安装依赖：确保 Python3 环境可用，安装所需依赖（本仓库中使用 asyncio、FastAPI、Starlette、uvicorn 等组件，按需安装依赖）。
  • 运行服务器：进入 memory-plugin/server 目录下执行主入口脚本，监听端口默认 8765，主机默认 127.0.0.1，可以通过环境变量 KG_HTTP_PORT 和 KG_HTTP_HOST 进行覆盖。
  • 连接客户端：MCP 客户端需要使用下述服务器配置信息来连接服务器并通过 JSON-RPC 与之交互。

• 服务器配置（MCP 客户端连接所需） 说明：以下 JSON 配置用于 MCP 客户端了解如何启动并连接到 MCP 服务器。服务器端实现提供命名、启动命令与参数，客户端仅需要此配置信息来发起连接。 { "server_name": "knowledge-graph-mcp", "command": ["python3", "memory-plugin/server/mcp_streamable_server.py"], "args": [] } 注释：

  • server_name：服务器在 MCP 客户端中的标识名称。
  • command：启动服务器的命令，建议直接以脚本方式启动以运行主入口 main。
  • args：启动参数，若不需要额外参数可留空；若你需要通过环境变量覆写端口/绑定地址，可在部署环境中设置 KG_HTTP_PORT、KG_HTTP_HOST，客户端配置不必强制包含这些内容。

• 基本使用方法

  • 启动服务器：在支持的环境中执行服务器启动命令，确保 Python3 环境就绪。
  • 客户端连接：使用 MCP 客户端发起连接，请求读取资源、注册会话、执行工具等操作。服务器将按 MCP 约定返回 JSON-RPC 风格的响应或通知。
  • 管理与维护：服务端提供健康检查、备份与日志机制，生产环境应结合现有监控与日志管控进行观测。

• 运行与调试要点

  • 服务器默认监听 127.0.0.1:8765，可通过环境变量 KG_HTTP_HOST、KG_HTTP_PORT 调整。
  • 备份策略包括最近备份、每日备份、每周备份，确保数据在长时间运行中的安全性。
  • 支持流式传输与 WebSocket 通道，以实现对 LLM 的低延迟通知。

• 注意事项

  • 该实现包含一个 Web/API 边界，用于可视化编辑与管理；生产环境请加强鉴权、鉴权策略和网络安全配置。