Skip to content
MCP server

Ariadne

Local-first multilingual memory for coding agents, with verified backups and isolation

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Windows, macOS, Linux
Runs
Locally
Version
0.8.26
Listing updated
3 days ago

About Ariadne

Ariadne is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Ariadne replaces memory backends that crash or starve when several agent sessions write at once. Instead of an embedded database, it keeps memories in a Qdrant server bound to 127.0.0.1, with Ollama serving the bge-m3 model locally. Dense multilingual meaning and exact BM25 terms are fused for retrieval, so the site says an English query can find Ukrainian notes.

Projects are isolated by default. A search across another project opens a scoped approval request that a person must decide in the tray menu, so an agent cannot quietly read another project. Recent releases focus on backups: a failed backup stays a warning until a successful one completes, a new full set must pass independent file, database and model recovery checks before it replaces the kept one, and an explicit repair mode keeps earlier copies.

It is written in Go and runs without Docker, a cloud account or API keys. Windows has a native x64 installer, and a shell installer is provided for Mac and Linux. Memory can be exported as portable JSONL or saved as full Qdrant snapshots.

Install

Run in a terminal

claude mcp add ariadne -- npx -y https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ariadne": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ariadne": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ariadne": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ariadne": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ariadne": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb"
      ]
    }
  }
}

Configuration

  • ARIADNE_QDRANT_HOSTQdrant host
  • ARIADNE_QDRANT_PORTQdrant gRPC port
  • ARIADNE_OLLAMAOllama API URL
  • ARIADNE_MODELEmbedding model
  • ARIADNE_COLLECTIONQdrant collection

What it does

Concurrent sessions
Qdrant serves several agents at once without file-lock starvation.
Multilingual recall
bge-m3 embeddings plus BM25 across 100+ languages.
Project isolation
Cross-project recall needs a visible human approval.
Verified backup rotation
New backup sets pass recovery checks before replacing the old one.
Visible failures
Failed backups stay flagged and notify again on each new failure.
Portable export
JSONL export or full Qdrant snapshots for moving memories.

Good for

  • Give Codex and Claude Code a shared memory across sessions
  • Recall notes written in another language
  • Keep one project's memory out of another's searches
  • Back up agent memory with tested recovery
  • Run agent memory fully offline

Pricing

Open source

Prices change. Check mclaut.github.io before you buy.

Ariadne FAQ

Does it send memory to the cloud?

No. The default stack uses local Qdrant and local Ollama endpoints.

Can several sessions use it at once?

Yes, Qdrant is a server and handles concurrent access natively.

Can an agent search another project silently?

No. Cross-project recall opens a scoped approval request first.

Can I move my memories later?

Yes, by exporting portable JSONL or taking full Qdrant snapshots.

Is Ariadne free?

Yes. Ariadne is open source, so you can use and self-host it for free.

How do I add Ariadne to Claude Code?

Run this command in your terminal: claude mcp add ariadne -- npx -y https://github.com/mclaut/ariadne/releases/download/v0.8.26/ariadne-v0.8.26.mcpb

What are the best alternatives to Ariadne?

The closest alternatives to Ariadne are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Ariadne

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools