README Documentation
mem0 MCP Server
A TypeScript implementation of the Model Context Protocol (MCP) server for mem0, providing memory stream functionality with Mem0 integration.
Features
- Create memory streams with Mem0 integration
- Append content to memory streams
- Search memories using Mem0's semantic search
- Read from memory streams
- Resource-based access to memory streams
- Delete memory streams
Prerequisites
- Node.js and npm installed
- Mem0 API key (get one from mem0.ai)
Installation
npm install
Configuration
Set your Mem0 API key as an environment variable:
export MEM0_API_KEY=your-api-key-here
Building
npm run build
Running the Server
npm start
Testing
Run the test client to verify server functionality:
npm test
API
Tools
-
create-memory-stream- Parameters:
name: stringinitialContent: string (optional)userId: string (optional) - Mem0 user IDagentId: string (optional) - Mem0 agent ID
- Returns: Stream ID and metadata
- Parameters:
-
append-to-stream- Parameters:
streamId: stringcontent: stringrole: "user" | "assistant" (optional)
- Returns: Success confirmation
- Parameters:
-
search-memories- Parameters:
query: stringuserId: stringagentId: string (optional)threshold: number (optional)
- Returns: Search results from Mem0
- Parameters:
-
read-stream- Parameters:
streamId: stringstartIndex: number (optional)endIndex: number (optional)
- Returns: Stream content
- Parameters:
-
delete-stream- Parameters:
streamId: string
- Returns: Deletion confirmation
- Parameters:
Resources
memory://{streamId}- Access memory stream content directlymemory://- List all memory streams
Development
The server is implemented using the MCP TypeScript SDK and provides integration with Mem0 for persistent memory storage and semantic search. To extend the implementation:
- Add more Mem0 features (e.g., memory tagging, metadata)
- Implement proper error handling
- Add authentication and authorization
- Add additional memory operations
License
MIT
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source