fluxmem-mcp 0.2.0

MCP server for FluxMem — memory + wiki tools for Claude Code, Cursor, Windsurf

FluxMem MCP Server

Use FluxMem memory natively in Claude Code, Cursor, Windsurf, and any MCP-compatible AI tool.

Setup

1. Install

pip install fluxmem-mcp
# or
uvx fluxmem-mcp

2. Configure environment

export FLUXMEM_API_KEY=fxm_your_key_here
export FLUXMEM_URL=http://localhost:8000
export FLUXMEM_NAMESPACE=user:default

3. Connect to your AI tool

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "fluxmem": {
      "command": "fluxmem-mcp",
      "env": {
        "FLUXMEM_API_KEY": "fxm_your_key_here",
        "FLUXMEM_URL": "http://localhost:8000",
        "FLUXMEM_NAMESPACE": "user:default"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "fluxmem": {
      "command": "fluxmem-mcp",
      "env": {
        "FLUXMEM_API_KEY": "fxm_your_key_here",
        "FLUXMEM_URL": "http://localhost:8000"
      }
    }
  }
}

Windsurf

Add in Windsurf MCP settings:

{
  "mcpServers": {
    "fluxmem": {
      "command": "fluxmem-mcp",
      "env": {
        "FLUXMEM_API_KEY": "fxm_your_key_here",
        "FLUXMEM_URL": "http://localhost:8000"
      }
    }
  }
}

Available Tools

Tool	Description
add_memory	Store a memory (episodic/semantic/procedural)
search_memory	Search for relevant memories
get_context	Get assembled context for LLM injection
reinforce_memory	Mark a memory as important
get_entity_profile	Get entity profile summary + facts

Available Resources

URI	Description
fluxmem://memory/{id}	Single memory by ID
fluxmem://entity/{ref}	Entity profile
fluxmem://stats/{namespace}	Namespace statistics

Available Prompts

Prompt	Description
remember_context	Fetch + inject relevant memory context before any query