MemGPT MCP Server

A TypeScript-based MCP server that implements a memory system for LLMs. It provides tools for chatting with different LLM providers while maintaining conversation history.

Features

Tools

chat - Send a message to the current LLM provider
- Takes a message parameter
- Supports multiple providers (OpenAI, Anthropic, OpenRouter, Ollama)
get_memory - Retrieve conversation history
- Optional limit parameter to specify number of memories to retrieve
- Pass limit: null for unlimited memory retrieval
- Returns memories in chronological order with timestamps
clear_memory - Clear conversation history
- Removes all stored memories
use_provider - Switch between different LLM providers
- Supports OpenAI, Anthropic, OpenRouter, and Ollama
- Persists provider selection
use_model - Switch to a different model for the current provider
- Supports provider-specific models:
  - Anthropic Claude Models:
    - Claude 3 Series:
      - claude-3-haiku: Fastest response times, ideal for tasks like customer support and content moderation
      - claude-3-sonnet: Balanced performance for general-purpose use
      - claude-3-opus: Advanced model for complex reasoning and high-performance tasks
    - Claude 3.5 Series:
      - claude-3.5-haiku: Enhanced speed and cost-effectiveness
      - claude-3.5-sonnet: Superior performance with computer interaction capabilities
  - OpenAI: 'gpt-4o', 'gpt-4o-mini', 'gpt-4-turbo'
  - OpenRouter: Any model in 'provider/model' format (e.g., 'openai/gpt-4', 'anthropic/claude-2')
  - Ollama: Any locally available model (e.g., 'llama2', 'codellama')
- Persists model selection

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "letta-memgpt": {
      "command": "/path/to/memgpt-server/build/index.js",
      "env": {
        "OPENAI_API_KEY": "your-openai-key",
        "ANTHROPIC_API_KEY": "your-anthropic-key",
        "OPENROUTER_API_KEY": "your-openrouter-key"
      }
    }
  }
}

Environment Variables

OPENAI_API_KEY - Your OpenAI API key
ANTHROPIC_API_KEY - Your Anthropic API key
OPENROUTER_API_KEY - Your OpenRouter API key

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Recent Updates

Claude 3 and 3.5 Series Support (March 2024)

Added support for latest Claude models:
- Claude 3 Series (Haiku, Sonnet, Opus)
- Claude 3.5 Series (Haiku, Sonnet)

Unlimited Memory Retrieval

Added support for retrieving unlimited conversation history
Use { "limit": null } with the get_memory tool to retrieve all stored memories
Use { "limit": n } to retrieve the n most recent memories
Default limit is 10 if not specified