Memgpt

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