Metadata-Version: 2.4
Name: fluxmem-mcp
Version: 0.2.0
Summary: MCP server for FluxMem — memory + wiki tools for Claude Code, Cursor, Windsurf
Project-URL: Homepage, https://fluxmem.org
Project-URL: Documentation, https://docs.fluxmem.org
Project-URL: Repository, https://github.com/fluxmem/fluxmem
Project-URL: Changelog, https://github.com/fluxmem/fluxmem/blob/main/mcp/CHANGELOG.md
Project-URL: Issues, https://github.com/fluxmem/fluxmem/issues
Author-email: FluxMem <hello@fluxmem.org>
License: MIT
License-File: LICENSE
Keywords: ai,claude-code,cursor,mcp,memory,model-context-protocol,wiki,windsurf
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: fluxmem-sdk>=0.2.0
Requires-Dist: mcp>=1.0
Description-Content-Type: text/markdown

# FluxMem MCP Server

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

## Setup

### 1. Install

```bash
pip install fluxmem-mcp
# or
uvx fluxmem-mcp
```

### 2. Configure environment

```bash
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`:

```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:

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

#### Windsurf

Add in Windsurf MCP settings:

```json
{
  "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 |
