Skip to main content

MCP Server for Mem-Brain API - Exposes memory operations as MCP tools

Project description

Mem-Brain MCP Server

MCP (Model Context Protocol) server that exposes Mem-Brain API functionality as standardized tools for AI agents. Built with FastMCP for production-ready HTTP/SSE transport.

Features

  • Memory CRUD and semantic search
  • Search modes: raw (graph-native), interpreted (LLM summary), both (summary + evidence)
  • Graph operations (path + neighborhood)
  • Stats and health endpoints
  • HTTP/SSE transport for remote MCP clients

Authentication

Mem-Brain MCP uses MemBrain API keys.

  • Preferred header in MCP client config: X-API-Key: mb_live_...
  • Also supported: Authorization: Bearer mb_live_...

Installation

PyPI

pip install mem-brain-mcp
mem-brain-mcp

uvx

uvx mem-brain-mcp

Configuration

API_BASE_URL=https://mem-brain-api-cutover-v4-production.up.railway.app
MEMBRAIN_API_KEY=mb_live_xxx   # optional fallback for single-user local runs
MCP_SERVER_HOST=0.0.0.0
MCP_SERVER_PORT=8100
LOG_LEVEL=INFO

MCP Client Examples

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "mem-brain": {
      "url": "http://localhost:8100/mcp",
      "headers": {
        "X-API-Key": "mb_live_xxx"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "mem-brain": {
      "url": "http://localhost:8100/mcp",
      "headers": {
        "X-API-Key": "mb_live_xxx"
      }
    }
  }
}

Development

pytest

Build / Publish

uv build
uv tool run twine upload dist/*

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mem_brain_mcp-1.1.3.tar.gz (118.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mem_brain_mcp-1.1.3-py3-none-any.whl (17.5 kB view details)

Uploaded Python 3

File details

Details for the file mem_brain_mcp-1.1.3.tar.gz.

File metadata

  • Download URL: mem_brain_mcp-1.1.3.tar.gz
  • Upload date:
  • Size: 118.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.7

File hashes

Hashes for mem_brain_mcp-1.1.3.tar.gz
Algorithm Hash digest
SHA256 fd3b9ebea6e52c173e6d1a179fafb61ade913e4e2beee7341d699cdb484b0b27
MD5 e91533e864a259b6dfaf5d8c16704bbb
BLAKE2b-256 d66d4ff0c7587bde3c50eb35274b26a6b67c0e09e6df016b59bae9379f7264eb

See more details on using hashes here.

File details

Details for the file mem_brain_mcp-1.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for mem_brain_mcp-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 ee3fbc492bd1c0d540bf883e607b7973c847d15b14a554ad74fee3a5ed94c824
MD5 6c873743a6a3b4ba89ccfe90ec19d57c
BLAKE2b-256 9a61b2270da1feb81f5375bd568c368d36017fdb09d9fbb91eff2779f3d78d8d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page