使用说明

项目简介

Memory MCP Server 是一个基于 Model Context Protocol (MCP) 构建的知识图谱管理服务器。它基于官方 MCP Servers - memory 改造,旨在为 LLM 应用提供结构化的知识存储和访问能力。该服务器主要用于托管和管理知识图谱数据,并提供相应的 API 接口供 MCP 客户端调用,以实现上下文信息的管理和检索。

主要功能点

  • 知识图谱管理: 提供实体、关系、观察的创建、删除、搜索和读取等功能,用于构建和维护知识图谱数据。
  • 数据持久化: 支持将知识图谱数据自动保存到 JSON 文件,并支持灵活配置数据存储路径,确保数据不丢失。
  • 多种启动方式: 支持交互式、命令行参数和 JSON 配置文件等多种启动方式,方便用户在不同场景下部署和运行服务器。
  • 灵活配置: 提供端口号和数据存储路径等配置选项,用户可以根据需求自定义服务器的运行参数。

安装步骤

该项目为编译后的可执行文件,无需安装步骤。

  1. 下载可执行文件: 从仓库 https://github.com/shadowcz007/memory_mcp 下载 'mcp_server_memory.exe' (或其他平台对应的可执行文件)。

服务器配置

MCP 客户端需要配置以下 JSON 信息以连接到 Memory MCP Server:

{
  "serverName": "memory_mcp_server",
  "command": "./mcp_server_memory.exe",
  "args": [
    "--port", "8080",  // (可选) 指定服务器端口,默认为 8080
    "--memory-path", "./memory.json" // (可选) 指定数据存储文件路径,默认为程序所在目录的 memory.json
  ]
}

参数注释:

  • 'serverName': 服务器名称,客户端用于标识连接的服务器。可以自定义。
  • 'command': MCP 服务器的启动命令。这里假设 'mcp_server_memory.exe' 文件与客户端在同一目录下,如果不在同一目录,请填写可执行文件的完整路径。
  • 'args': 启动命令的参数列表,以数组形式提供。
    • '--port': 指定服务器监听的端口号。如果省略,则使用默认端口 8080。
    • '--memory-path': 指定知识图谱数据存储的 JSON 文件路径。如果省略,则默认在程序所在目录创建 'memory.json' 文件。

注意: 请根据实际情况修改 'command' 和 'args' 中的路径和参数。

基本使用方法

  1. 启动服务器: 根据上述服务器配置,启动 'mcp_server_memory.exe' 服务器。
  2. 配置 MCP 客户端: 在 MCP 客户端中,配置上述 JSON 信息,建立与 Memory MCP Server 的连接。
  3. 使用 MCP 客户端 API: 通过 MCP 客户端提供的 API,调用 Memory MCP Server 提供的实体、关系、观察等操作接口,进行知识图谱的管理和查询。 例如,可以使用 'create_entities' 接口创建实体,使用 'search_nodes' 接口搜索节点等。 具体 API 接口请参考 "API 接口" 部分的描述。

信息

分类

数据库与文件