feat: Mem0 Memory MCP Server (with npx command)

Author: deshraj

node/mem0/.gitignore

@@ -8,3 +8,4 @@
 
 node_modules
 build
+dist

node/mem0/README.md

@@ -1,4 +1,4 @@
-# Mem0 Memory Tool
+# Mem0 Memory MCP Server
 
 A Model Context Protocol (MCP) server that provides memory storage and retrieval capabilities using [Mem0](https://github.com/mem0ai/mem0). This tool allows you to store and search through memories, making it useful for maintaining context and making informed decisions based on past interactions.
 
@@ -8,101 +8,221 @@ A Model Context Protocol (MCP) server that provides memory storage and retrieval
 - Search through stored memories with relevance scoring
 - Simple and intuitive API
 - Built on the Model Context Protocol
-
-## Prerequisites
-
-- Node.js (v14 or higher)
-- A Mem0 API key [(Get Here)](https://app.mem0.ai/dashboard/api-keys)
+- Automatic error handling
+- Support for multiple user contexts
 
 ## Installation
 
-1. Clone the repository
-2. Install dependencies:
+### Running with npx
+
 ```bash
-npm install
+env MEM0_API_KEY=your-api-key-here npx -y @mem0/mcp
 ```
 
-3. Create a `.env` file in the root directory and add your Mem0 API key:
+### Manual Installation
+
 ```bash
-MEM0_API_KEY=your-api-key-here
+npm install -g @mem0/mcp
 ```
 
-## Usage
+## Configuration for AI Tools
 
-The server provides two main tools:
+### Running on Cursor
+
+#### Configuring Cursor 🖥️
+
+To configure Mem0 MCP in Cursor:
+
+1. Open Cursor Settings
+2. Go to Features > MCP Servers
+3. Click "+ Add New MCP Server"
+4. Enter the following:
+   - Name: "mem0-mcp" (or your preferred name)
+   - Type: "command"
+   - Command: `env MEM0_API_KEY=your-api-key-here npx -y @mem0/mcp`
+
+To configure Mem0 MCP using JSON configuration:
+
+```json
+{
+  "mcpServers": {
+    "mem0-mcp": {
+      "command": "npx",
+      "args": ["-y", "@mem0/mcp"],
+      "env": {
+        "MEM0_API_KEY": "YOUR-API-KEY-HERE"
+      }
+    }
+  }
+}
+```
 
-### 1. Adding Memories
+### Running on VS Code
 
-Store new memories with user-specific context:
+Add the following JSON block to your User Settings (JSON) file in VS Code:
 
-```typescript
-await server.tool("add-memory", {
-  content: "User prefers dark mode interface",
-  userId: "alice"
-});
+```json
+{
+  "mcp": {
+    "inputs": [
+      {
+        "type": "promptString",
+        "id": "apiKey",
+        "description": "Mem0 API Key",
+        "password": true
+      }
+    ],
+    "servers": {
+      "mem0-memory": {
+        "command": "npx",
+        "args": ["-y", "@mem0/mcp"],
+        "env": {
+          "MEM0_API_KEY": "${input:apiKey}"
+        }
+      }
+    }
+  }
+}
 ```
 
-### 2. Searching Memories
+## Available Tools
 
-Search through stored memories to retrieve relevant information:
+### 1. Add Memory Tool (add-memory)
 
-```typescript
-const results = await server.tool("search-memories", {
-  query: "What are the user's interface preferences?",
-  userId: "alice"
-});
+Store new memories with user-specific context.
+
+```json
+{
+  "name": "add-memory",
+  "arguments": {
+    "content": "User prefers dark mode interface",
+    "userId": "user123"
+  }
+}
 ```
 
-The search results will include:
-- Memory content
-- Relevance score
-- Formatted output for easy integration
+### 2. Search Memories Tool (search-memories)
+
+Search through stored memories to retrieve relevant information.
+
+```json
+{
+  "name": "search-memories",
+  "arguments": {
+    "query": "What are the user's interface preferences?",
+    "userId": "user123"
+  }
+}
+```
 
 ## Response Format
 
 ### Add Memory Response
+
 ```json
 {
   "content": [
     {
       "type": "text",
       "text": "Memory added successfully"
     }
-  ]
+  ],
+  "isError": false
 }
 ```
 
 ### Search Memory Response
+
 ```json
 {
   "content": [
     {
       "type": "text",
-      "text": "Memory: User prefers dark mode interface\nRelevance: 0.95\n---"
+      "text": "Memory: User prefers dark mode interface\nRelevance: 0.95\n---\nMemory: User mentioned liking minimal UI\nRelevance: 0.82\n---"
     }
-  ]
+  ],
+  "isError": false
 }
 ```
 
+## Configuration
+
+### Environment Variables
+
+- `MEM0_API_KEY`: Your Mem0 API key (required)
+  - Required for operation
+  - Can be obtained from [Mem0 Dashboard](https://app.mem0.ai/dashboard/api-keys)
+
 ## Development
 
+### Prerequisites
+
+- Node.js (v14 or higher)
+- A Mem0 API key
+
+### Setup
+
+1. Clone the repository
+2. Install dependencies:
+```bash
+npm install
+```
+
+3. Create a `.env` file in the root directory and add your Mem0 API key:
+```bash
+MEM0_API_KEY=your-api-key-here
+```
+
+### Running Development Server
+
 To run the server in development mode:
 
 ```bash
 npm run dev
 ```
 
-## Building
+### Building
 
 To build the project:
 
 ```bash
 npm run build
 ```
 
-## Environment Variables
+### Starting the Server
 
-- `MEM0_API_KEY`: Your Mem0 API key (required)
+To start the server after building:
+
+```bash
+npm start
+```
+
+## Error Handling
+
+The server includes error handling for:
+
+- API connection issues
+- Invalid memory operations
+- Search errors
+- Authentication failures
+
+Example error response:
+
+```json
+{
+  "content": [
+    {
+      "type": "text",
+      "text": "Error: Failed to search memories: Invalid API key"
+    }
+  ],
+  "isError": true
+}
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
 
 ## License