Metadata-Version: 2.4
Name: recollect-mcp
Version: 0.3.1
Summary: MCP server for Recollect
License-Expression: MIT
Requires-Python: >=3.12.4
Requires-Dist: humanize>=4.15.0
Requires-Dist: mcp>=1.26.0
Requires-Dist: recollect
Description-Content-Type: text/markdown

# recollect-mcp

MCP server that gives AI assistants persistent, human-like memory via the Recollect SDK.

## Install

```bash
pip install recollect-mcp
```

## Usage

```bash
# stdio transport (default)
recollect-mcp

# streamable-http transport (production)
recollect-mcp --transport http
```

## MCP Client Config

Add to `.mcp.json` or `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "memory": {
      "command": "recollect-mcp",
      "args": []
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `remember` | Store an experience as a memory trace with LLM-extracted patterns |
| `recall` | Retrieve relevant memories for a query within a token budget |
| `pin` | Promote a memory so it resists decay |
| `unpin` | Remove promotion from a previously pinned memory |
| `forget` | Weaken or remove a memory trace |

## Resources

| Resource | Description |
|----------|-------------|
| `primer` | Relational graph built from extracted persona facts |
| `facts` | Raw persona facts with temporal weighting |
| `health` | Server and database health status |

## Requirements

- Python 3.12+
- PostgreSQL 17 with pgvector
- `ANTHROPIC_API_KEY` environment variable (for LLM pattern extraction)

Sessions are managed server-side -- no session configuration needed from the client.

## License

See [LICENSE](../../LICENSE) for details.
