EvolutionDB Long-Term Memory MCP Server

Name: EvolutionDB Long-Term Memory MCP Server
Author: io.github.alptekin

io.github.alptekin/evolutiondb-memory

Repository Registry

What is the EvolutionDB Long-Term Memory MCP server?

Persistent long-term memory for Claude Desktop / Claude Code, backed by EvolutionDB.

How to install EvolutionDB Long-Term Memory

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

EVOSQL_HOST
Hostname where EvolutionDB is reachable on the PostgreSQL wire (port 5433).
EVOSQL_PORT
EvolutionDB's PostgreSQL-protocol port.
EVOSQL_USER
Database user.
EVOSQL_PASSWORD
secret
Database password.
EVOSQL_DATABASE
Database name to use.
MCP_USER_ID
required
Sticky namespace identifier for every memory Claude writes through this server. Server-side override — the LLM cannot fragment your namespace by inventing other IDs.
MCP_STORE_PREFIX
Prefix for the auto-created MEMORY STORE / ENTITY STORE catalog objects.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "evolutiondb-memory": {
      "command": "python3",
      "args": [
        "mcp-server-evolutiondb"
      ],
      "env": {
        "EVOSQL_HOST": "<YOUR_EVOSQL_HOST>",
        "EVOSQL_PORT": "<YOUR_EVOSQL_PORT>",
        "EVOSQL_USER": "<YOUR_EVOSQL_USER>",
        "EVOSQL_PASSWORD": "<YOUR_EVOSQL_PASSWORD>",
        "EVOSQL_DATABASE": "<YOUR_EVOSQL_DATABASE>",
        "MCP_USER_ID": "<YOUR_MCP_USER_ID>",
        "MCP_STORE_PREFIX": "<YOUR_MCP_STORE_PREFIX>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "evolutiondb-memory": {
      "command": "python3",
      "args": [
        "mcp-server-evolutiondb"
      ],
      "env": {
        "EVOSQL_HOST": "<YOUR_EVOSQL_HOST>",
        "EVOSQL_PORT": "<YOUR_EVOSQL_PORT>",
        "EVOSQL_USER": "<YOUR_EVOSQL_USER>",
        "EVOSQL_PASSWORD": "<YOUR_EVOSQL_PASSWORD>",
        "EVOSQL_DATABASE": "<YOUR_EVOSQL_DATABASE>",
        "MCP_USER_ID": "<YOUR_MCP_USER_ID>",
        "MCP_STORE_PREFIX": "<YOUR_MCP_STORE_PREFIX>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "evolutiondb-memory": {
      "command": "python3",
      "args": [
        "mcp-server-evolutiondb"
      ],
      "env": {
        "EVOSQL_HOST": "<YOUR_EVOSQL_HOST>",
        "EVOSQL_PORT": "<YOUR_EVOSQL_PORT>",
        "EVOSQL_USER": "<YOUR_EVOSQL_USER>",
        "EVOSQL_PASSWORD": "<YOUR_EVOSQL_PASSWORD>",
        "EVOSQL_DATABASE": "<YOUR_EVOSQL_DATABASE>",
        "MCP_USER_ID": "<YOUR_MCP_USER_ID>",
        "MCP_STORE_PREFIX": "<YOUR_MCP_STORE_PREFIX>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "evolutiondb-memory": {
      "type": "stdio",
      "command": "python3",
      "args": [
        "mcp-server-evolutiondb"
      ],
      "env": {
        "EVOSQL_HOST": "<YOUR_EVOSQL_HOST>",
        "EVOSQL_PORT": "<YOUR_EVOSQL_PORT>",
        "EVOSQL_USER": "<YOUR_EVOSQL_USER>",
        "EVOSQL_PASSWORD": "<YOUR_EVOSQL_PASSWORD>",
        "EVOSQL_DATABASE": "<YOUR_EVOSQL_DATABASE>",
        "MCP_USER_ID": "<YOUR_MCP_USER_ID>",
        "MCP_STORE_PREFIX": "<YOUR_MCP_STORE_PREFIX>"
      }
    }
  }
}

Claude Code

claude mcp add evolutiondb-memory --env EVOSQL_HOST=<YOUR_EVOSQL_HOST> --env EVOSQL_PORT=<YOUR_EVOSQL_PORT> --env EVOSQL_USER=<YOUR_EVOSQL_USER> --env EVOSQL_PASSWORD=<YOUR_EVOSQL_PASSWORD> --env EVOSQL_DATABASE=<YOUR_EVOSQL_DATABASE> --env MCP_USER_ID=<YOUR_MCP_USER_ID> --env MCP_STORE_PREFIX=<YOUR_MCP_STORE_PREFIX> -- python3 mcp-server-evolutiondb