ceorkm/kratos-mcp
If you are the rightful owner of kratos-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Kratos MCP is a memory system designed for AI coding tools, ensuring that AI retains project-specific knowledge across sessions.
๐๏ธ Kratos MCP
Memory System for AI Coding Tools
Never explain your codebase again. Let AI remember everything.
๐ kratos-mcp.com โข Installation โข Quick Start โข Features โข Documentation โข Contributing
๐ฏ 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 the Four Pillars Frameworkโa battle-tested system that gives AI perfect memory of your project.
โจ Features
๐ 100% Project IsolationEach project gets its own SQLite database. No cross-contamination. Ever. |
๐ฏ 95.8% Context AccuracySmart retrieval engine that knows exactly what memories matter for your current task. |
โก Zero ConfigurationAuto-detects projects via git, package.json, or directory structure. Just install and code. |
๐ Universal ProtocolWorks with Claude, Cursor, Windsurf, Continueโany MCP-compatible tool. |
๐ 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
Claude Desktop
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": []
}
}
}
Claude Code (Anthropic's VSCode Extension)
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
See Claude Code MCP docs for more info.
Cursor
Add to .cursor/mcp_config.json
in your project root:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Windsurf (Codeium)
Add to ~/.windsurf/mcp_config.json
:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Cline (VSCode Extension)
- Open VSCode Command Palette (Cmd+Shift+P)
- Run "Cline: Edit MCP Settings"
- Add server configuration:
{
"kratos": {
"command": "npx",
"args": ["kratos-mcp"]
}
}
BoltAI
- Open BoltAI Settings
- Navigate to MCP Servers
- Add new server with:
{
"name": "kratos",
"command": "npx",
"args": ["kratos-mcp"]
}
Augment Code
Add to Augment settings under MCP configuration:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Roo Code (VSCode Extension)
Add to .roo/config.json
:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Zencoder
Configure in Zencoder settings:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Amazon Q Developer
Add to Q Developer settings:
{
"mcpServers": [
{
"name": "kratos",
"command": "npx",
"args": ["kratos-mcp"]
}
]
}
Qodo Gen
Add to Qodo configuration:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
JetBrains AI Assistant
- Open Settings โ Tools โ AI Assistant
- Add MCP server:
{
"kratos": {
"command": "npx",
"args": ["kratos-mcp"]
}
}
Warp Terminal
Add to ~/.warp/mcp_config.json
:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Opencode
Configure in Opencode settings:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Copilot Coding Agent
Add to Copilot configuration:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Kiro
Add to Kiro settings:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
OpenAI Codex
Configure in Codex settings:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
LM Studio
Add to LM Studio MCP configuration:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Perplexity Desktop
Add to Perplexity settings:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Continue.dev
Add to ~/.continue/config.json
:
{
"models": [...],
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["kratos-mcp"]
}
}
}
Zed
Add to ~/.config/zed/settings.json
:
{
"assistant": {
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["kratos-mcp"]
}
}
}
}
VS Code (Generic MCP Extensions)
For any MCP-compatible VS Code extension, add to .vscode/settings.json
:
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Other MCP Tools
Kratos works with any tool supporting the Model Context Protocol. The general format is:
{
"command": "npx",
"args": ["kratos-mcp"]
}
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
๐๏ธ The Four Pillars Framework
Based on real-world experience building 30+ production apps with AI, Kratos implements the Four Pillars of effective AI development:
๐ Pillar 1: PRD (Product Requirements)
"What Matters"
Define not just what to build, but how AI should build it:
- Complete page paths and user flows
- API endpoints and data structures
- Edge cases and integration points
- UI/UX references and patterns
๐ฏ Pillar 2: Prompt Templates
"What to Do"
Reusable task templates that work perfectly with your codebase:
- Role & stack definition
- Clear scope constraints
- File context specifications
- Verification steps
๐ง Pillar 3: Context Retrieval
"What to Inject"
Smart injection of relevant memories based on your current task:
- Automatic pattern matching
- Path-based relevance scoring
- Recency weighting
- Semantic clustering
๐พ Pillar 4: Memory Storage
"What to Save"
Permanent knowledge base that grows with your project:
- Architecture decisions
- Bug fixes and solutions
- Feature implementations
- Performance optimizations
๐ ๏ธ Core Tools
Tool | Description | Example |
---|---|---|
memory_save | Store important project knowledge |
|
memory_search | Retrieve relevant memories |
|
prd_update | Define project requirements |
|
prompt_build | Create reusable prompts |
|
๐ How It Works
graph LR
A[Your Code] --> B[Kratos MCP]
B --> C{Project Detection}
C --> D[Project Database]
D --> E[Memory Storage]
D --> F[Context Broker]
F --> G[AI Tool]
G --> H[Perfect Context]
๐ฌ Under the Hood
- 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
๐ Performance
Metric | Value |
---|---|
Context Accuracy | 95.8% |
Memory Retrieval | < 10ms |
Project Switch | < 100ms |
Storage Overhead | ~2MB per project |
๐๏ธ Memory Structure
.kratos/
โโโ projects/
โ โโโ project-id-1/
โ โ โโโ memories.db # SQLite database
โ โ โโโ prd.yml # Product requirements
โ โ โโโ prompts/ # Reusable templates
โ โโโ project-id-2/
โ โโโ ...
โโโ config.yml # Global configuration
๐ฎ Live Demo
// User: "Explain the auth system"
//
// Kratos automatically retrieves:
// โ JWT implementation from 2 weeks ago
// โ Middleware configuration from last month
// โ User model structure from initial setup
// โ Security decisions from PRD
//
// AI Response: "Your auth uses JWT with refresh tokens
// stored in httpOnly cookies. The middleware validates
// tokens on protected routes at /api/middleware/auth.ts:42..."
๐ค Contributing
We welcome contributions! See for guidelines.
# Clone the repo
git clone https://github.com/ceorkm/kratos-mcp.git
# Install dependencies
npm install
# Run in development
npm run dev
๐ License
MIT ยฉ 2025 Kratos MCP Contributors
๐ Acknowledgments
Built on the Model Context Protocol by Anthropic.
Inspired by the Four Pillars Framework and real-world experience building production apps with AI.
Built for developers who value their time.
Report Bug โข Request Feature โข Documentation