# Nautilus Compass Memory

An MCP server for local long-term memory, session search, and drift checks for AI agents. Use it when Claude Code needs context across sessions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1254
- Author: chunxiaoxx
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/chunxiaoxx/nautilus-compass
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/nautilus-compass-memory

## What it does

Nautilus Compass Memory provides local long-term memory for AI agents. It embeds raw text with BGE-m3, keeps data on the machine, and routes retrieval between utterance-level chunks and session-level search. The session mode combines BM25 with dense RRF. Ingest does not use an extraction LLM or a graph.

The server scores each prompt against an anchor set before the agent acts, which helps detect drift in the current instruction. It also includes cross-agent contracts, while the project description mentions byte-recomputable signed verification receipts. You can run it locally with `uvx` or connect over HTTP at `https://compass.nautilus.social/mcp/`.

The local setup uses `uvx`, so that command must be available for this option. The HTTP setup uses the remote MCP endpoint instead.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://compass.nautilus.social/mcp/`

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add nautilus-compass -- uvx nautilus-compass
```
uvx runs the command named after the package; if the README names another one, use uvx --from nautilus-compass <command>

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http nautilus-compass-memory https://compass.nautilus.social/mcp/
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add nautilus-compass-memory --url https://compass.nautilus.social/mcp/
```

2. **Platform CLI**
```bash
codex mcp add nautilus-compass-memory -- uvx nautilus-compass
```
uvx runs the command named after the package; if the README names another one, use uvx --from nautilus-compass <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nautilus-compass-memory": {
            "url": "https://compass.nautilus.social/mcp/"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nautilus-compass-memory": {
            "command": "uvx",
            "args": [
                "nautilus-compass"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from nautilus-compass <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "nautilus-compass-memory": {
            "type": "http",
            "url": "https://compass.nautilus.social/mcp/"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "nautilus-compass-memory": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "nautilus-compass"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from nautilus-compass <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http nautilus-compass-memory https://compass.nautilus.social/mcp/
```

2. **Platform CLI**
```bash
gemini mcp add nautilus-compass-memory uvx nautilus-compass
```
uvx runs the command named after the package; if the README names another one, use uvx --from nautilus-compass <command>

## When to use it
- retain agent memory across sessions
- retrieve facts from individual user turns
- check prompts for drift before an action
- coordinate several agents through contracts

## Example prompts
- Save this project decision to long-term memory for later sessions.
- Search memory for the previous authentication fix in this project.
- Check my current prompt for drift against the stored rules.

## Similar
- [mem0](https://affpapa.org/en/nevibecode/skills/mem0.md) — skill · 2300 installs
- [mem0-cli](https://affpapa.org/en/nevibecode/skills/mem0-cli.md) — skill · 773 installs
- [renaissance-architecture](https://affpapa.org/en/nevibecode/skills/renaissance-architecture.md) — skill · 3300 installs
- [architecture-compass](https://affpapa.org/en/nevibecode/skills/architecture-compass.md) — skill · 2700 installs
- [skill-compass](https://affpapa.org/en/nevibecode/skills/skill-compass.md) — skill · ★ 216

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md