内存网状结构（MemoryMesh）

概述

MemoryMesh 是一个用于在 Claude Desktop 上集成 MCP 服务器的项目。通过它可以将结构化数据与 AI 推理能力相结合。本文档详细介绍了如何安装、配置和使用 MemoryMesh。

安装指南

步骤 1：下载源代码

使用以下命令克隆仓库并进入目录：

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

步骤 2：安装依赖项

在项目根目录运行以下命令以安装所有依赖项：

npm install

步骤 3：构建项目

构建 TypeScript 代码并生成可执行文件：

npm run build

此命令会在 dist 目录下生成 JavaScript 文件，并将示例数据和模式文件复制到该目录。

步骤 4：配置 Claude Desktop

编辑你的Claude Desktop 配置文件，添加以下内容：

• macOS：路径为 ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：路径为 %APPDATA%\Claude\claude_desktop_config.json

在 mcpServers 对象中添加如下配置：

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

将 /ABSOLUTE/PATH/TO/YOUR/PROJECT/ 替换为你的项目实际路径。

步骤 5：重启 Claude Desktop

完成配置后，重启应用以使更改生效。

验证安装

1. 打开 Claude Desktop。
2. 创建一个新的聊天窗口。
3. 查看右上角的 MCP 插件图标。如果看到该图标，说明服务器已成功连接。
4. 点击图标，查看是否列出了 memorymesh 服务。
5. 点击.hammer-icon，检查是否有工具（如 add_npc、update_npc 等）显示。

更新指南

在进行更新之前，请务必备份 dist/data 目录下的文件，以防数据丢失。

故障排除

问题：服务器未出现在 Claude Desktop 中

• 检查配置文件中的路径是否正确且为绝对路径。
• 确认 dist 目录存在且包含 index.js 文件。
• 查看日志文件以获取错误信息：
  • macOS：路径为 ~/Library/Logs/Claude/mcp-server-memorymesh.log
  • Windows：路径位于 %AppData%\Claude

问题：工具未显示

• 确保 npm run build 命令运行无误。
• 检查模式文件是否正确放置在 dist/data/schemas 目录中，并遵循命名规范（如 add_[entity].schema.json）。

高级配置

变量

通过 /config/config.ts 文件可以覆盖默认设置：

• MEMORY_FILE：指定存储知识图谱数据的 JSON 文件路径（默认值为 dist/data/memory.json）。
• SCHEMAS_DIR：模式文件目录路径（默认值为 dist/data/schemas/memory.json）。

限制

1. 节点删除：AI 可能不愿意从知识图谱中删除节点。