⚙

AI编码记忆系统

Kratos MCP是一款为AI编码工具设计的超轻量级记忆系统，通过本地SQLite数据库实现项目隔离和完美记忆召回，适用于各类MCP兼容的AI开发工具。

作者 By ceorkm

本地部署 AI辅助开发代码记忆

GitHub

奎托斯MCP

用于AI编码工具的超精益存储系统

永远不要再解释你的代码库。让AI记住一切。

奎托斯已经进化了。这个回购现在是遗留的。

`github.com/ceorkm/kratos-cli`

Kratos现在是一个独立的CLI——更快、更轻，可与任何AI代理配合使用。

无MCP开销。没有供应商锁定。只有有效的内存。

BASH``` 1npx kratos-memory


**克劳德代码、Codex、Cursor、Cline** --任何运行Bash的东西。


你现有的记忆会立即发挥作用。相同 `~/.kratos/` 存储，相同的SQLite格式。


### [`Go to Kratos CLI >`](https://github.com/ceorkm/kratos-cli)




---


## 为什么是奎托斯？


在用人工智能构建了30多个生产应用程序后，我们发现了一个关键问题： **AI工具在会话之间忘记一切**。你解释你的架构、模式、决定——明天，你再解释一遍。


奎托斯MCP通过一个 **超瘦记忆系统** 这使AI能够完美地回忆起你的项目，同时将上下文开销降至最低。


## 特性


| ### 100%项目隔离


每个项目都有自己的SQLite数据库。无交叉污染。永远。 | ### 零配置


通过git、package.json或目录结构自动检测项目。只需安装和编码。 |
| --- | --- |
| ### 超精益架构


只有12个基本工具。比竞争对手的上下文足迹小64%。 | ### 普遍协议


适用于Claude、Cursor、Windsurf、Continue——任何兼容MCP的工具。 |


## 安装


BASH```
1
2
3
4
5
6# 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

JSON``` 1 2 3 4 5 6 7 8{ “mcpServers”: { “kratos”: { “command”: “npx”, “args”: [“—yes”, “kratos-mcp@latest”] } } }


或者，如果您已全局安装：


JSON```
1
2
3
4
5
6
7
8{
  "mcpServers": {
    "kratos": {
      "command": "kratos-mcp",
      "args": []
    }
  }
}

Claude Code 在终端中运行以下命令：

BASH``` 1claude mcp add kratos — npx —yes kratos-mcp@latest


或者进行全局安装：


BASH```
1
2
3
4# 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 在项目根目录中：

JSON``` 1 2 3 4 5 6 7 8{ “mcpServers”: { “kratos”: { “command”: “npx”, “args”: [“—yes”, “kratos-mcp@latest”] } } }




Other MCP Tools
Kratos可以使用任何支持模型上下文协议的工具。一般格式为：


JSON```
1
2
3
4{
  "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.开始使用奎托斯

TYPESCRIPT``` 1 2 3 4 5 6// 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` | 获取系统状态和内存统计信息 |


## 运作原理

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


- **SQLite+FTS5**：闪电般快速的全文搜索
- **智能评分**：路径匹配+最近性+重要性
- **自动检测**：Git、package.json或基于目录
- **安全**：所有数据都保持在本地，没有外部呼叫
- **精益**：只有4个核心组件，内存占用最小


## 演出


| 度量 | 值 |
| --- | --- |
| 上下文开销 | 比v3小64% |
| 内存检索 | <10ms |
| 项目切换 | <100ms |
| 存储开销 | 每个项目约2MB |


## 数据存储

1 2 3 4 5 6 7 8~/.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` 用于每个项目的存储。


## 示例用法


TYPESCRIPT```
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19// 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
});

贡献

BASH``` 1 2 3 4git clone https://github.com/ceorkm/kratos-mcp.git npm install npm run build npm run dev


## 许可证


麻省理工学院



---



**专为重视时间的开发人员打造。**


[报告Bug](https://github.com/ceorkm/kratos-mcp/issues) · [请求功能](https://github.com/ceorkm/kratos-mcp/issues)