使用说明
奎托斯MCP
用于AI编码工具的超精益存储系统
永远不要再解释你的代码库。让AI记住一切。
奎托斯已经进化了。这个回购现在是遗留的。
github.com/ceorkm/kratos-cli
Kratos现在是一个独立的CLI——更快、更轻，可与任何AI代理配合使用。
无MCP开销。没有供应商锁定。只有有效的内存。
npx kratos-memory
克劳德代码、Codex、Cursor、Cline --任何运行Bash的东西。
你现有的记忆会立即发挥作用。相同 ~/.kratos/ 存储，相同的SQLite格式。
Go to Kratos CLI >
为什么是奎托斯？
在用人工智能构建了30多个生产应用程序后，我们发现了一个关键问题： AI工具在会话之间忘记一切。你解释你的架构、模式、决定——明天，你再解释一遍。
奎托斯MCP通过一个 超瘦记忆系统 这使AI能够完美地回忆起你的项目，同时将上下文开销降至最低。
特性
100%项目隔离每个项目都有自己的SQLite数据库。无交叉污染。永远。 |
零配置通过git、package.json或目录结构自动检测项目。只需安装和编码。 |
超精益架构只有12个基本工具。比竞争对手的上下文足迹小64%。 |
普遍协议适用于Claude、Cursor、Windsurf、Continue——任何兼容MCP的工具。 |
安装
# 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
快速开始
1.配置您的AI工具
Claude Desktop
添加到您的Claude Desktop配置文件中：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/claude/claude_desktop_config.json
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
或者，如果您已全局安装：
{
"mcpServers": {
"kratos": {
"command": "kratos-mcp",
"args": []
}
}
}
Claude Code
在终端中运行以下命令：
claude mcp add kratos -- npx --yes kratos-mcp@latest
或者进行全局安装：
# First install globally
npm install -g kratos-mcp@latest
# Then add to Claude Code
claude mcp add kratos -- kratos-mcp
Cursor
增添 .cursor/mcp_config.json 在项目根目录中：
{
"mcpServers": {
"kratos": {
"command": "npx",
"args": ["--yes", "kratos-mcp@latest"]
}
}
}
Other MCP Tools
Kratos可以使用任何支持模型上下文协议的工具。一般格式为：
{
"command": "npx",
"args": ["kratos-mcp"]
}
兼容： Windsurf、Cline、BoltAI、Augment Code、Roo Code、Zencoder、Amazon Q、Qodo Gen、JetBrains AI、Warp、Opencode、Continue.dev、Zed等等！
检查工具的文档以了解特定的MCP服务器配置位置。
2.开始使用奎托斯
// Your AI now remembers:
// - Your authentication patterns
// - Your API structure
// - Your component architecture
// - Your coding standards
// - Every decision you've made
可用工具
奎托斯提供 12种超精益工具 优化以最小化上下文消耗：
内存管理（7个工具）
| 工具 | 说明 |
|---|---|
memory_save |
用标签、路径和重要性级别存储重要的项目知识 |
memory_search |
具有调试模式和路径匹配的智能语义搜索 |
memory_ask |
关于你记忆的自然语言查询 |
memory_get_recent |
通过过滤获取最近创建的记忆 |
memory_get |
按ID检索特定内存 |
memory_get_multiple |
批量检索多个内存 |
memory_forget |
按ID删除内存 |
安全（1个工具）
| 工具 | 说明 |
|---|---|
security_scan |
保存前扫描文本以查找PII和机密 |
项目管理（3个工具）
| 工具 | 说明 |
|---|---|
project_switch |
在不同项目之间切换 |
project_current |
获取当前活动项目信息 |
change_storage_path |
通过自动数据迁移动态更改存储位置 |
系统（1个工具）
| 工具 | 说明 |
|---|---|
system_status |
获取系统状态和内存统计信息 |
运作原理
AI Tool ──► Kratos MCP ──► Project Detection ──► SQLite + FTS5 ──► Perfect Context
- SQLite+FTS5：闪电般快速的全文搜索
- 智能评分：路径匹配+最近性+重要性
- 自动检测：Git、package.json或基于目录
- 安全：所有数据都保持在本地，没有外部呼叫
- 精益：只有4个核心组件，内存占用最小
演出
| 度量 | 值 |
|---|---|
| 上下文开销 | 比v3小64% |
| 内存检索 | <10ms |
| 项目切换 | <100ms |
| 存储开销 | 每个项目约2MB |
数据存储
~/.kratos/
├── projects/
│ ├── project-id-1/
│ │ └── memories.db # SQLite database with FTS5
│ └── project-id-2/
│ └── memories.db
└── global/
└── global.db # Shared knowledge (optional)
使用 change_storage_path 将数据移动到自定义位置，如 /opt/kratos 或 .kratos 用于每个项目的存储。
示例用法
// 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
});
贡献
git clone https://github.com/ceorkm/kratos-mcp.git
npm install
npm run build
npm run dev
许可证
麻省理工学院
专为重视时间的开发人员打造。
