Memorymesh

🚀 MemoryMesh

MemoryMesh is a project for integrating MCP servers on Claude Desktop. It combines structured data with AI inference capabilities. This document details how to install, configure, and use MemoryMesh.

🚀 Quick Start

MemoryMesh enables the integration of MCP servers on Claude Desktop, effectively combining structured data with AI inference capabilities. This guide will walk you through the installation, configuration, and usage of MemoryMesh.

📦 Installation

Step 1: Download the Source Code

Clone the repository and navigate to the directory using the following commands:

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

Step 2: Install Dependencies

Run the following command in the project's root directory to install all dependencies:

npm install

Step 3: Build the Project

Build the TypeScript code and generate executable files:

npm run build

This command will generate JavaScript files in the dist directory and copy sample data and schema files to that directory.

Step 4: Configure Claude Desktop

Edit your Claude Desktop configuration file and add the following content:

• macOS: The path is ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: The path is %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration to the mcpServers object:

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

Replace /ABSOLUTE/PATH/TO/YOUR/PROJECT/ with the actual path to your project.

Step 5: Restart Claude Desktop

After completing the configuration, restart the application for the changes to take effect.

📋 Verification of Installation

1. Open Claude Desktop.
2. Create a new chat window.
3. Check the MCP plugin icon in the top - right corner. If you see the icon, it means the server is successfully connected.
4. Click the icon to see if the memorymesh service is listed.
5. Click the.hammer - icon to check if tools (such as add_npc, update_npc, etc.) are displayed.

🔄 Update Guide

Before updating, be sure to back up the files in the dist/data directory to prevent data loss.

🛠️ Troubleshooting

Issue: The server does not appear in Claude Desktop

• Check if the path in the configuration file is correct and an absolute path.
• Confirm that the dist directory exists and contains the index.js file.
• Check the log file for error information:
  • macOS: The path is ~/Library/Logs/Claude/mcp - server - memorymesh.log
  • Windows: The path is in %AppData%\Claude

Issue: Tools are not displayed

• Ensure that the npm run build command runs without errors.
• Check if the schema files are correctly placed in the dist/data/schemas directory and follow the naming convention (e.g., add_[entity].schema.json).

⚙️ Advanced Configuration

Variables

You can override the default settings through the /config/config.ts file:

• MEMORY_FILE: Specify the path to the JSON file storing the knowledge graph data (default value is dist/data/memory.json).
• SCHEMAS_DIR: The path to the schema file directory (default value is dist/data/schemas/memory.json).

🚫 Limitations

1. Node Deletion: The AI may be reluctant to delete nodes from the knowledge graph.