使用说明

项目简介

Knowledge Graph Memory Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它使用本地知识图谱来存储和管理信息，为大型语言模型 (LLM) 提供持久化的记忆能力，使 LLM 能够在多次对话中记住用户的信息和偏好。

主要功能点

• 知识图谱存储: 使用实体、关系和观察来构建和存储结构化知识。
• 实体和关系管理: 提供创建、删除、更新实体和关系的功能。
• 观察管理: 允许向实体添加、删除观察信息。
• 知识检索: 支持基于关键词搜索知识图谱中的实体和关系。
• 指定节点读取: 根据名称读取特定的实体及其关系。

安装步骤

• Docker: 确保已安装 Docker。使用仓库中提供的 'Dockerfile' 构建 Docker 镜像 'mcp/memory'。

  docker build -t mcp/memory -f src/memory/Dockerfile .
  

• NPX: 确保已安装 Node.js 和 npm。可以直接使用 'npx' 运行，无需额外安装步骤。

服务器配置

• Docker:

  {
    "mcpServers": {
      "memory": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/memory"]
      }
    }
  }
  

  配置说明：

  • 'command': 启动服务器的命令，这里使用 'docker'。
  • 'args': 命令参数，'run -i --rm mcp/memory' 表示运行 'mcp/memory' 镜像，'-i' 保持 STDIN 打开，即使没有连接，'-rm' 容器退出时自动删除。

• NPX:

  {
    "mcpServers": {
      "memory": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-memory"
        ]
      }
    }
  }
  

  配置说明：

  • 'command': 启动服务器的命令，这里使用 'npx'。
  • 'args': 命令参数，'-y @modelcontextprotocol/server-memory' 表示使用 'npx' 运行 '@modelcontextprotocol/server-memory' 包，'-y' 自动确认安装包。

• NPX with custom setting:

  {
    "mcpServers": {
      "memory": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-memory"
        ],
        "env": {
          "MEMORY_FILE_PATH": "/path/to/custom/memory.json"
        }
      }
    }
  }
  

  配置说明：

  • 'command': 启动服务器的命令，这里使用 'npx'。
  • 'args': 命令参数，'-y @modelcontextprotocol/server-memory' 表示使用 'npx' 运行 '@modelcontextprotocol/server-memory' 包，'-y' 自动确认安装包。
  • 'env': 环境变量配置，'MEMORY_FILE_PATH' 用于指定知识图谱数据存储文件的路径，默认为服务器目录下的 'memory.json'。

基本使用方法

1. 将上述配置信息添加到 MCP 客户端的配置文件中（例如 Claude Desktop 的 'claude_desktop_config.json'）。
2. 启动 MCP 客户端。客户端将根据配置连接到 Knowledge Graph Memory Server。
3. LLM 可以通过调用服务器提供的工具来操作知识图谱，例如使用 'create_entities' 工具创建实体，使用 'search_nodes' 工具检索信息等。 具体工具和使用方式请参考仓库 README.md 文件中 API 章节的描述。