mem0 MCP工具

Prerequisites 🔑

This server supports three storage modes:

1. Cloud Storage Mode ☁️ (Recommended for production) Requires a Mem0 API key (provided as MEM0_API_KEY environment variable) Memories are persistently stored on Mem0's cloud servers No local database needed Full feature support with advanced filtering and search

2. Supabase Storage Mode 🗄️ (Recommended for self-hosting) Requires Supabase credentials (SUPABASE_URL and SUPABASE_KEY environment variables) Requires OpenAI API key (OPENAI_API_KEY environment variable) for embeddings Memories are persistently stored in your Supabase database Free tier available, self-hostable option * Requires initial database setup (SQL migrations provided below)

3. Local Storage Mode 💾 (Development/testing only) Requires an OpenAI API key (provided as OPENAI_API_KEY environment variable) Memories are stored in an in-memory vector database (non-persistent by default) * Data is lost when the server restarts unless configured for persistent storage

Installation & Configuration ⚙️

You can run this server in three main ways:

Installing via Smithery

To install Mem0 Memory Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @pinkpixel-dev/mem0-mcp-server --client claude

1. Global Installation (Recommended for frequent use)

Install the package globally and use the mem0-mcp command:

npm install -g @pinkpixel/mem0-mcp

After global installation, you can run the server directly:

mem0-mcp

Configure your MCP client to use the global command:

Cloud Storage Configuration (Global Install)

{
  "mcpServers": {
    "mem0-mcp": {
      "command": "mem0-mcp",
      "args": [],
      "env": {
        "MEM0_API_KEY": "YOUR_MEM0_API_KEY_HERE",
        "DEFAULT_USER_ID": "user123",
        "DEFAULT_AGENT_ID": "your-agent-id",
        "DEFAULT_APP_ID": "your-app-id"
      }
    }
  }
}

Supabase Storage Configuration (Global Install)

{
  "mcpServers": {
    "mem0-mcp": {
      "command": "mem0-mcp",
      "args": [],
      "env": {
        "SUPABASE_URL": "YOUR_SUPABASE_PROJECT_URL",
        "SUPABASE_KEY": "YOUR_SUPABASE_ANON_KEY",
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE",
        "DEFAULT_USER_ID": "user123",
        "DEFAULT_AGENT_ID": "your-agent-id",
        "DEFAULT_APP_ID": "your-app-id"
      }
    }
  }
}

Local Storage Configuration (Global Install)

{
  "mcpServers": {
    "mem0-mcp": {
      "command": "mem0-mcp",
      "args": [],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE",
        "DEFAULT_USER_ID": "user123"
      }
    }
  }
}

Supabase Setup 🗄️

If you choose to use Supabase storage mode, you'll need to set up your Supabase database with the required table.

3. Set Environment Variables

Add these to your MCP configuration:

• SUPABASE_URL: Your Supabase project URL (e.g., https://your-project.supabase.co)
• SUPABASE_KEY: Your Supabase anon key
• OPENAI_API_KEY: Your OpenAI API key (for embeddings)

Parameter Configuration 🎯

Environment Variable Fallbacks 🔄

The MCP server supports environment variable fallbacks for user identification and project settings:

• DEFAULT_USER_ID: Fallback user ID when not provided in tool calls
• DEFAULT_AGENT_ID: Fallback agent ID for identifying the LLM/agent
• DEFAULT_APP_ID: Fallback app ID for project scoping

#### Priority Order (Important!) 1. Tool Parameters (highest priority) - Values provided by the LLM in tool calls 2. Environment Variables (fallback) - Values from your MCP configuration

#### Example Behavior:

// Your MCP config
"env": {
  "DEFAULT_USER_ID": "john-doe",
  "DEFAULT_AGENT_ID": "my-assistant",
  "DEFAULT_APP_ID": "my-project"
}

If LLM provides parameters:

{
  "tool": "add_memory",
  "arguments": {
    "content": "Remember this",
    "userId": "session-123",        // ← Overrides DEFAULT_USER_ID
    "agentId": "different-agent",   // ← Overrides DEFAULT_AGENT_ID
    "appId": "special-project"      // ← Overrides DEFAULT_APP_ID
    // sessionId omitted           // ← No fallback, will be undefined
  }
}

If LLM omits parameters:

{
  "tool": "add_memory",
  "arguments": {
    "content": "Remember this"
    // All IDs omitted - uses environment variables
  }
}

#### Controlling LLM Behavior To ensure your environment variables are used, instruct your LLM: - "Use the default user ID configured in the environment" - "Don't specify userId, agentId, or appId parameters" - "Let the server use the configured defaults"

#### System Prompt Recommendation For best results, include instructions in your system prompt like:

When creating memories, use:
- agentId: "my-assistant"
- appId: "my-project"
- sessionId: "current-conversation-id"

Example configuration using DEFAULT_USER_ID:

{
  "mcpServers": {
    "mem0-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/mem0-mcp"
      ],
      "env": {
        "MEM0_API_KEY": "YOUR_MEM0_API_KEY_HERE",
        "DEFAULT_USER_ID": "user123",
        "ORG_ID": "your-org-id",
        "PROJECT_ID": "your-project-id"
      }
    }
  }
}

Or when running directly with node:

git clone https://github.com/pinkpixel-dev/mem0-mcp
cd mem0-mcp
npm install
npm run build

{
  "mcpServers": {
    "mem0-mcp": {
      "command": "node",
      "args": [
        "path/to/mem0-mcp/build/index.js"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY_HERE",
        "DEFAULT_USER_ID": "user123"
      }
    }
  }
}

Cloud Storage (Mem0 API) ☁️

• Persistent by default - Your memories remain available across sessions and server restarts
• No local database required - All data is stored on Mem0's servers
• Higher retrieval quality - Uses Mem0's optimized search algorithms
• Additional fields - Supports agent_id and threshold parameters
• Fully managed - No setup or maintenance required
• Requires - A Mem0 API key

Local Storage (OpenAI API) 💾

• In-memory by default - Data is stored only in RAM and is not persistent long-term. While some caching may occur, you should not rely on this for permanent storage.
• Data loss risk - Memory data will be lost on server restart, system reboot, or if the process is terminated
• Recommended for - Development, testing, or temporary use only
• For persistent storage - Use the Cloud Storage or Supabase options if you need reliable long-term memory
• Uses OpenAI embeddings - For vector search functionality
• Self-contained - All data stays on your machine
• Requires - An OpenAI API key

Storage Mode Comparison 🔄