MemoryMesh 使用说明

项目简介

MemoryMesh 是一个本地知识图谱服务器，专为 AI 模型设计，尤其适用于文本 RPG 和互动故事等应用。它可以帮助 AI 模型在多轮对话中维护一致且结构化的记忆，从而实现更丰富和动态的交互体验。

主要功能点

动态模式驱动的工具: 基于用户定义的模式自动生成用于增、删、改知识图谱数据的工具。
直观的模式设计: 使用 JSON 模式定义知识图谱的结构，包括节点类型、属性、关系等。
支持节点和边: 知识图谱由节点（实体或概念）和边（关系）组成，支持元数据和权重。
多种工具: 自动生成基于模式的工具 (add, update, delete)，以及预定义的静态工具 (节点/边/元数据管理、搜索)。
本地 JSON 文件存储: 知识图谱数据默认存储在本地 JSON 文件中。
可视化工具: 提供独立的 Memory Viewer 工具，用于可视化和检查知识图谱内容。

安装步骤

安装 Node.js: 确保已安装 Node.js (版本 18 或更高)。

克隆仓库:

git clone https://github.com/CheMiguel23/memorymesh.git

进入目录:
```
cd memorymesh
```
安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

要将 MemoryMesh 配置为 MCP 服务器，您需要在 MCP 客户端（例如 Claude Desktop）的配置文件中添加以下服务器配置信息。以下配置信息为 JSON 格式，您需要根据实际的项目路径进行调整：

{
  "mcpServers": {
    "memorymesh": {
      "command": "node",  // 启动命令，使用 node.js 运行时
      "args": ["/ABSOLUTE/PATH/TO/YOUR/PROJECT/memorymesh/dist/index.js"] // 启动参数，指向编译后的服务器入口文件
      // 请将 "/ABSOLUTE/PATH/TO/YOUR/PROJECT/memorymesh" 替换为 MemoryMesh 项目的绝对路径，例如：
      // "args": ["/Users/yourusername/Projects/memorymesh/dist/index.js"] (macOS)
      // "args": ["C:\\Projects\\memorymesh\\dist\\index.js"] (Windows)
    }
  }
}

配置步骤：

找到 Claude Desktop 配置文件:
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
编辑配置文件: 打开 'claude_desktop_config.json' 文件，在 '"mcpServers"' 部分添加上述 JSON 配置。如果 'mcpServers' 部分不存在，请手动创建。
重启 Claude Desktop: 完成配置后，请完全重启 Claude Desktop 客户端，以确保配置生效。

基本使用方法

启动 Claude Desktop: 启动配置了 MemoryMesh MCP 服务器的 Claude Desktop 客户端。
开始对话: 在 Claude Desktop 中开始新的聊天。
检查 MCP 连接: 观察 Claude Desktop 界面右上角是否有 MCP 插件图标，点击图标应能看到 "memorymesh" 服务器已连接。
使用知识图谱工具: 在与 Claude 的对话中，您可以使用自然语言指令，指示 Claude 使用 MemoryMesh 提供的工具来管理知识图谱。例如，您可以指示 Claude "添加一个新的 NPC 角色，名字叫 'Aragorn'，种族是人类，职业是游侠" 等等。MemoryMesh 会根据预定义的模式自动生成相应的工具，并响应 Claude 的工具调用请求，从而实现对知识图谱的动态操作。

更详细的使用方法和高级配置，请参考仓库的 README.md 文件和相关文档。

关键词