Memorymesh

🚀 內存網狀結構（MemoryMesh）

MemoryMesh 是一個用於在Claude Desktop上集成MCP服務器的項目，它能將結構化數據與AI推理能力相結合。本文檔將詳細介紹MemoryMesh的安裝、配置和使用方法。

🚀 快速開始

MemoryMesh可實現結構化數據與AI推理能力的結合，以下將為你介紹其安裝、配置及使用的詳細步驟。

📦 安裝指南

步驟 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可能不願意從知識圖譜中刪除節點。