# Chaos Cypher

> Chaos Cypher is an open-source MCP server for knowledge and memory. Local-first knowledge graph engine with GraphRAG search and a 46-tool MCP server. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, Web, API
- **Website:** https://chaoscypher.com
- **Repository:** https://github.com/chaoscypherinc/chaoscypher
- **MCP Registry name:** io.github.chaoscypherinc/chaoscypher
- **Categories:** knowledge and memory, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

The MCP interface is one part of a larger self-hosted engine. Chaos Cypher extracts entities and relationships from documents, audio, video, images and web pages (30+ formats) into a graph you can explore and correct, then lets assistants query it. The README says the MCP server exposes 46 tools for search, traversal and graph building to Claude Desktop, Cursor, ChatGPT and other clients.

Search fuses graph traversal with vector search using Personalized PageRank and Reciprocal Rank Fusion, with keyword, semantic and hybrid modes as alternatives. Answers cite the sources and connections behind them. Extraction and chat can run fully offline through Ollama or use OpenAI, Anthropic or Gemini, configured per operation.

By default only the LLM calls you configure leave your machine; embeddings are computed locally. Knowledge can be exported as a portable `.ccx` package. The vendor's own benchmark on 22 local models reports fewer failed answers than plain vector RAG; those are the vendor's figures. It installs from PyPI as `chaoscypher-cli` or runs as a Docker container.

## Features

- **Inspectable graph:** Explore entities and relationships on a filterable graph canvas.
- **GraphRAG search:** Combines graph traversal with vector search plus keyword and hybrid modes.
- **Cited chat:** Answers trace back to sources and connections.
- **Local or cloud LLMs:** Use Ollama offline or OpenAI, Anthropic and Gemini per operation.
- **Portable packages:** Export sources, graph and settings as one .ccx file.
- **Quality scoring:** Rates graph richness 0-100 and flags weak sources.
- **Automations:** Visual workflow builder with triggers and conditions.

## Good for

- Let Claude query a private document collection as a graph
- Trace an answer back to its source passages
- Build a knowledge base from PDFs, audio and video offline
- Share a knowledge graph with a teammate as a package

## Install

### Claude Code (Terminal)

```sh
claude mcp add chaoscypher -- uvx chaoscypher-cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "chaoscypher": {
      "command": "uvx",
      "args": [
        "chaoscypher-cli"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "chaoscypher": {
      "command": "uvx",
      "args": [
        "chaoscypher-cli"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "chaoscypher": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "chaoscypher-cli"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "chaoscypher": {
      "command": "uvx",
      "args": [
        "chaoscypher-cli"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "chaoscypher": {
      "command": "uvx",
      "args": [
        "chaoscypher-cli"
      ]
    }
  }
}
```

## FAQ

### Does my data leave my machine?

By default only the LLM calls you configure do; embeddings are local, and a local Ollama model keeps everything on-device.

### Which formats can it ingest?

More than 30, including PDF, DOCX, Markdown, HTML, EPUB, audio, video, images and ZIP archives.

### How many MCP tools are there?

The README says 46 tools for search, traversal and graph building.

### How do I run it?

Install `chaoscypher-cli` from PyPI or run the Docker image from ghcr.io.

### Is Chaos Cypher free?

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

### How do I add Chaos Cypher to Claude Code?

Run this command in your terminal: claude mcp add chaoscypher -- uvx chaoscypher-cli

### What are the best alternatives to Chaos Cypher?

The closest alternatives to Chaos Cypher are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/chaos-cypher
