记忆网格

MemoryMesh 是一款专为 AI 模型设计的知识图谱服务器，专注于基于文本的角色扮演游戏 (RPG) 和交互式故事叙述。它帮助 AI 在对话过程中保持一致的结构化记忆，从而实现更丰富、更动态的交互。

该项目基于 MCP 服务器存储库中的

重要的

从v0.2.7开始，schema 的默认位置更改为dist/data/schemas 。此位置预计未来不会更改，但如果您要从旧版本更新，请确保将 schema 文件移动到新位置。

快速链接

• 安装

• 例子

• SchemaManager 指南讨论

• MemoryViewer 指南讨论

概述

MemoryMesh 是一个本地知识图谱服务器，可帮助您构建和管理 AI 模型的结构化信息。它尤其适用于基于文本的角色扮演游戏 (RPG)，但其灵活的设计使其适用于各种应用，包括社交网络模拟、组织规划或任何涉及结构化数据的场景。

主要特点

• **基于动态模式的工具：**使用模式定义数据结构，MemoryMesh 会自动生成用于添加、更新和删除数据的工具。

• **直观的模式设计：**使用必填字段、枚举类型和关系定义创建指导 AI 生成和连接节点的模式。

• **用于 AI 指导的元数据：**使用元数据提供上下文和结构，帮助 AI 理解数据中的含义和关系。

• **关系处理：**在您的模式中定义关系以鼓励 AI 在相关数据点（节点）之间创建连接（边）。

• **信息反馈：**向人工智能提供错误反馈，使其能够从错误中学习并改善其与知识图谱的交互。

• **事件支持：**事件系统跟踪操作，提供有关知识图如何被修改的见解。

节点

节点表示知识图谱中的实体或概念。每个节点具有：

• name ：唯一标识符。

• nodeType ：节点的类型（例如， npc 、 artifact 、 location ），由您的模式定义。

• metadata ：提供有关节点描述性详细信息的字符串数组。

• weight ：（可选）0 到 1 之间的数值，表示关系的强度，默认为 1。

示例节点：

边缘

边表示节点之间的关系。每条边具有：

• from ：源节点的名称。

• to ：目标节点的名称。

• edgeType ：关系的类型（例如， owns 、 located_in ）。

模式

Schema 是 MemoryMesh 的核心。它定义了数据的结构并驱动工具的自动生成。

架构文件位置

将你的 schema 文件 ( .schema.json ) 放在你构建的 MemoryMesh 项目的dist/data/schemas目录中。MemoryMesh 会在启动时自动检测并处理这些文件。

模式结构

文件名： [name].schema.json 。例如，对于定义 'npc' 的架构，文件名将是add_npc.schema.json 。

• name - 内存中模式和节点类型的标识符。重要提示：模式名称必须以add_开头才能被识别。

• description - 用于add_<name>工具的描述，为 AI 提供上下文。 （

• properties ——每个属性包括其类型、描述和附加约束。

  • property

    • type - 支持的值是string或array 。

    • description - 帮助指导 AI 实现实体的目的。

    • required - 布尔值。如果为true ，则AI 在创建节点时必须提供此属性。

    • enum - 字符串数组。如果存在， AI 必须从给定的选项中选择一个。

    • relationship - 定义与另一个节点的连接。如果某个属性是必需的且具有关系，则AI 将始终创建该节点及其对应的边。

      • edgeType - 要创建的关系类型。

      • description ——帮助引导 AI 了解关系的目的。

• additionalProperties - 布尔值。如果为true ，则允许 AI 添加除必需或可选属性之外的额外属性。

示例架构（add_npc.schema.json）：

基于此模式，MemoryMesh 自动创建：

• add_npc：添加新的NPC节点。

• update_npc：修改现有的NPC节点。

• delete_npc：删除NPC节点。

MemoryMesh 包含 11 个专为基于文本的 RPG 设计的预建模式，为游戏开发提供了可立即使用的基础。

SchemaManager工具

MemoryMesh 包含一个SchemaManager 工具，用于简化模式的创建和编辑。它提供了一个可视化界面，让您可以轻松定义数据结构，而无需直接编写 JSON。

动态工具

MemoryMesh 通过动态工具简化了与知识图谱的交互。这些工具无需手动编码，而是直接从您的模式定义中自动生成。这意味着，当您使用模式定义数据结构时，MemoryMesh 会智能地创建一组专门用于处理该特定数据结构的工具。

**可以这样想：**您提供一个蓝图（模式），MemoryMesh 会根据该蓝图自动构建必要的工具来构建、修改和删除元素。

幕后是如何运作的？

MemoryMesh 拥有一个智能系统，可以读取您的架构定义。它会分析您定义的结构，包括实体的属性及其关系。基于此分析，它会为每种实体类型自动创建一组工具：

• **add_<entity> ：**用于创建实体新实例的工具。

• **update_<entity> ：**用于修改现有实体的工具。

• **delete_<entity> ：**用于删除实体的工具。

然后，这些工具通过 MemoryMesh 内的中央枢纽提供，确保任何连接的客户端或 AI 都可以轻松访问和使用它们。

本质上，MemoryMesh 的动态工具系统提供了一种强大而有效的方法来管理您的知识图谱，让您可以专注于应用程序的内容和逻辑，而不是数据操作的底层机制。

内存文件

默认情况下，数据存储在dist/data/memory.json中的 JSON 文件中。

内存查看器

Memory Viewer 是一个独立的工具，旨在帮助您可视化和检查由 MemoryMesh 管理的知识图谱的内容。它提供了一个用户友好的界面，用于探索节点、边及其属性。

主要特点：

• 图形可视化：将知识图谱视为交互式节点链接图。

• 节点检查：选择节点以查看其节点类型、元数据和连接边。

• 边缘探索：检查节点之间的关系，包括边缘类型和方向。

• 搜索和过滤：快速查找特定节点或按类型过滤它们。

• 表格视图：允许您轻松查找和检查特定节点和边，或一次查找和检查所有节点和边。

• 原始 JSON 视图：允许您查看来自内存文件的原始 JSON 数据。

• 统计面板：提供有关知识图谱的关键指标和信息：节点总数、边总数、节点类型和边类型。

• 搜索和过滤：允许您按节点类型或边类型进行过滤，并过滤是否显示节点、边或两者。

访问内存查看器

内存查看器是一个独立的 Web 应用程序。内存查看器讨论

使用内存查看器

• 选择内存文件：在内存查看器中，单击“选择内存文件”按钮。

• 选择文件：导航到您的 MemoryMesh 项目目录并选择memory.json文件（默认位于dist/data/memory.json ）。

• 探索：内存查看器将加载并显示您的知识图谱的内容。

记忆流

迅速的

为了获得最佳效果，请结合使用 Claude 的“项目”功能和自定义指令。以下是您可以参考的提示示例：

您还可以在聊天中直接指示 AI 执行特定操作。

尝试不同的提示来找到最适合您的用例的提示！

例子

1. 带有自定义指令的简单示例。

2. 为了举例说明，并带有可视化功能（不属于功能的一部分）

添加几个城市、一些 NPC、城市周围几个可供探索的地点，在某处隐藏一两件文物

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 MemoryMesh：

先决条件

• **Node.js：**版本 18 或更高版本。您可以从nodejs.org下载。

• **npm：**通常包含在 Node.js 中。

• **桌面版 Claude：**确保您已从claude.ai/download安装了最新版本。

安装步骤

1. 克隆存储库：

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

2. 安装依赖项：

   npm install

3. 构建项目：

   npm run build

   此命令将 TypeScript 代码编译为dist目录中的 JavaScript，并将示例模式和数据文件复制到其中。

4. 验证文件副本（可选）：

   • 构建过程应自动将data文件夹复制到dist 。

   • 检查dist/data是否存在且包含.json文件。同时，验证dist/data/schemas是否存在且包含.schema.json文件。

5. 配置Claude桌面：

   打开您的 Claude Desktop 配置文件：

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows： %APPDATA%\Claude\claude_desktop_config.json

   • 在mcpServers部分添加一个用于memorymesh的条目。您可以选择以下配置选项之一：

   "mcpServers": { "memorymesh": { "command": "node", "args": ["/ABSOLUTE/PATH/TO/YOUR/PROJECT/memorymesh/dist/index.js"] } }

   • 将/ABSOLUTE/PATH/TO/YOUR/PROJECT/替换为您的memorymesh项目目录的实际绝对路径。

   • 示例（macOS）：

     "command": "node", "args": ["/Users/yourusername/Projects/memorymesh/dist/index.js"]

   • 示例（Windows）：

     "command": "node", "args": ["C:\\Projects\\memorymesh\\dist\\index.js"]

6. **重新启动 Claude Desktop：**完全重新启动 Claude Desktop 以使更改生效。

验证安装

1. 启动 Claude Desktop。

2. 打开新的聊天。

3. 在右上角找到 MCP 插件图标。如果找到，则说明您的配置很可能正确。

4. 点击图标。你应该会在已连接的服务器列表中看到“memorymesh”。

5. 点击图标。如果你看到列出的工具（例如add_npc 、 update_npc等），则表示你的服务器正常运行，并且工具已正确公开。

更新

更新之前，请确保备份dist/data目录以避免丢失内存数据。

故障排除

• 服务器未出现在 Claude 中：

  • 仔细检查claude_desktop_config.json中的路径。确保它们是绝对路径并且正确无误。

  • 验证dist目录是否存在并包含已编译的 JavaScript 文件，包括index.js 。

  • 检查 Claude Desktop 日志中是否存在错误：

    • macOS： ~/Library/Logs/Claude/mcp-server-memorymesh.log （和mcp.log ）

    • **Windows：（**可能位于%AppData%\Claude下的Logs文件夹中）

• 工具未显示：

  • 确保您的npm run build命令顺利完成。

  • 验证您的模式文件是否正确放置在dist/data/schemas中并遵循正确的命名约定（ add_[entity].schema.json ）。

  • 检查服务器的控制台输出或日志，查看初始化期间是否存在任何错误。

高级配置

除了基本设置之外，MemoryMesh 还提供了几种自定义其行为的方法：

变量

您可以使用/config/config.ts覆盖默认设置

• MEMORY_FILE：指定用于存储知识图谱数据的 JSON 文件的路径。（默认值： dist/data/memory.json ）

• SCHEMAS_DIR：架构文件目录的路径。（默认值： dist/data/schemas/memory.json ）

限制

1. 节点删除： AI 可能不愿意从知识图谱中删除节点。如果需要，可以通过提示来鼓励它。

贡献

欢迎贡献、反馈和想法！本项目是个人探索如何将结构化数据与 AI 推理能力相结合。欢迎贡献、反馈和想法，以推动项目进一步发展或启发新的项目。