Kratos MCP

npx kratos-memory

Why Kratos?

After building 30+ production apps with AI, we discovered a critical problem: AI tools forget everything between sessions. You explain your architecture, your patterns, your decisions—and tomorrow, you explain it all again.

Kratos MCP solves this with an ultra-lean memory system that gives AI perfect recall of your project—with minimal context overhead.

Features

Installation

# Install globally
npm install -g kratos-mcp

# Or run directly with npx (no installation required)
npx kratos-mcp

# Or install as a dependency
npm install kratos-mcp

Quick Start

1. Configure Your AI Tool

Add to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "kratos": {
      "command": "npx",
      "args": ["--yes", "kratos-mcp@latest"]
    }
  }
}

Or if you have it installed globally:

{
  "mcpServers": {
    "kratos": {
      "command": "kratos-mcp",
      "args": []
    }
  }
}

Run this command in your terminal:

claude mcp add kratos -- npx --yes kratos-mcp@latest

Or for global installation:

# First install globally
npm install -g kratos-mcp@latest

# Then add to Claude Code
claude mcp add kratos -- kratos-mcp

Add to .cursor/mcp_config.json in your project root:

{
  "mcpServers": {
    "kratos": {
      "command": "npx",
      "args": ["--yes", "kratos-mcp@latest"]
    }
  }
}

Kratos works with any tool supporting the Model Context Protocol. The general format is:

{
  "command": "npx",
  "args": ["kratos-mcp"]
}

Compatible with: Windsurf, Cline, BoltAI, Augment Code, Roo Code, Zencoder, Amazon Q, Qodo Gen, JetBrains AI, Warp, Opencode, Continue.dev, Zed, and more!

Check your tool's documentation for specific MCP server configuration location.

2. Start Using Kratos

// Your AI now remembers:
// - Your authentication patterns
// - Your API structure
// - Your component architecture
// - Your coding standards
// - Every decision you've made

Available Tools

Kratos provides 12 ultra-lean tools optimized for minimal context consumption:

Memory Management (7 tools)

Security (1 tool)

Project Management (3 tools)

System (1 tool)

How It Works

AI Tool ──► Kratos MCP ──► Project Detection ──► SQLite + FTS5 ──► Perfect Context

• SQLite + FTS5: Lightning-fast full-text search
• Smart Scoring: Path matching + recency + importance
• Auto-detection: Git, package.json, or directory-based
• Secure: All data stays local, no external calls
• Lean: Only 4 core components, minimal memory footprint

Performance

Data Storage

~/.kratos/
├── projects/
│   ├── project-id-1/
│   │   └── memories.db          # SQLite database with FTS5
│   └── project-id-2/
│       └── memories.db
└── global/
    └── global.db                # Shared knowledge (optional)

Use change_storage_path to move data to custom locations like /opt/kratos or .kratos for per-project storage.

Example Usage

// Save a memory
await memory_save({
  summary: "JWT auth implementation",
  text: "We use httpOnly cookies with refresh tokens...",
  tags: ["auth", "security"],
  paths: ["src/middleware/auth.ts"],
  importance: 5
});

// Search memories
await memory_search({
  q: "authentication",
  k: 5,
  debug: true
});

// Ask natural language questions
await memory_ask({
  question: "How does our auth system work?",
  limit: 10
});

Contributing

git clone https://github.com/ceorkm/kratos-mcp.git
npm install
npm run build
npm run dev

License

MIT