Memory MCP

A persistent, cross-provider memory server using FastMCP, Langchain, and Postgres.

Features

• MCP Server that agents can use to store facts about the user
• Transferrable across providers - usable across multiple agents
• Compatible with any MCP-capable agent (Claude Desktop, Claude Code, Opencode, etc.)
• Backed by Postgres to ensure data persistence and scalability
• Support multiple users from a single server
• Exposes two tools to your agent:
  • search_memory: Search the database for memories about the user
  • upsert_memory: Add/update memories for the user

Prerequisites

• Docker/Podman compose
• Openshift CLI

Usage

Local

1. Clone the repository:

   git clone https://github.com/taagarwa-rh/memory_mcp.git
   cd memory_mcp
   

2. Spin up the services:

   # For Podman
   podman compose up -d
   
   # For Docker
   docker compose up -d
   

   The MCP server will now be available at http://localhost:1313/mcp

Openshift

1. (Optional) Update the postgres username and password in secret.yaml

2. Deploy the resources

   oc apply -n <your-namespace> -f deploy
   

3. Fetch the route:

   ROUTE=$(oc get route memory-mcp -o jsonpath='{.spec.host}')
   ROUTE="https://$ROUTE/mcp"
   echo $ROUTE
   

Connect to Agents

Claude Desktop

{
    "mcpServers": {
        "memory": {
            "transport": "http",
            "url": "<mcp-route>",
            "headers": {
                "X-User-Id": "your_user_id"
            }
        }
    }
}

Claude Code

claude mcp add --transport http memory https://<mcp-route>/mcp --header "X-User-Id: <your-username>"

OpenCode

opencode mcp add

Location: Either Name: memory Type: Remote URL: https://<mcp-route>/mcp

Then in your opencode.json, add the user ID header:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "memory": {
      "type": "remote",
      "url": "https://<mcp-route>/mcp",
      "headers": {
        "X-User-Id": "<your-username>"
      }
    }
  }
}