星战科技xingzhan.cloud
返回市场
克罗托斯-MCP

克罗托斯-MCP

作者：ceorkm15 星标更新：2025-10-13
安装使用来源：spider==github.com

项目介绍

<div align="center">

🏛️ Kratos MCP

面向AI编码工具的超轻量级内存系统

npm 版本 许可证: MIT MCP 兼容 TypeScript

再也不用解释你的代码库了。让AI记住一切。

🌐 kratos-mcp.com • 安装 • 快速开始 • 特性 • 工具

</div>

🎯 为什么选择 Kratos？

在构建了30多个生产应用程序后，我们发现了一个关键问题：AI工具在会话之间忘记了所有内容。你需要解释你的架构、模式和决策——而第二天，你又得重新解释一遍。

Kratos MCP通过一个超轻量级的内存系统解决了这个问题，该系统使AI能够完美地记住你的项目，同时保持最小的上下文开销。

✨ 特性

<table> <tr> <td width="50%">

🔒 100% 项目隔离

每个项目都有自己的SQLite数据库。绝无交叉污染。

</td> <td width="50%">

⚡ 零配置

自动检测项目，通过git、package.json或目录结构。只需安装并开始编码。

</td> </tr> <tr> <td width="50%">

🪶 超轻量级架构

仅包含12个核心工具。比竞争对手减少64%的上下文占用。

</td> <td width="50%">

🌍 通用协议

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

</td> </tr> </table>

🚀 安装

# 全局安装
npm install -g kratos-mcp

# 或直接运行（无需安装）
npx kratos-mcp

# 或作为依赖项安装
npm install kratos-mcp

🎬 快速开始

1️⃣ 配置你的AI工具

<details> <summary><b>Claude Desktop</b></summary>

添加到你的Claude Desktop配置文件中：

  • 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"]
    }
  }
}

或者如果你全局安装了它：

{
  "mcpServers": {
    "kratos": {
      "command": "kratos-mcp",
      "args": []
    }
  }
}
</details> <details> <summary><b>Claude Code (Anthropic的VSCode扩展)</b></summary>

在终端中运行以下命令：

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

或者对于全局安装：

# 首先全局安装
npm install -g kratos-mcp@latest

# 然后添加到Claude Code
claude mcp add kratos -- kratos-mcp

更多信息请参阅Claude Code MCP文档。

</details> <details> <summary><b>Cursor</b></summary>

添加到项目根目录下的.cursor/mcp_config.json：

{
  "mcpServers": {
    "kratos": {
      "command": "npx",
      "args": ["--yes", "kratos-mcp@latest"]
    }
  }
}
</details> <details> <summary><b>其他MCP工具</b></summary>

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服务器配置位置。

</details>

2️⃣ 开始使用Kratos

// 你的AI现在记得：
// ✓ 认证模式
// ✓ API结构
// ✓ 组件架构
// ✓ 编码标准
// ✓ 每一个你做出的决定

🛠️ 可用工具

Kratos提供了12个超轻量级工具，优化了最小的上下文消耗：

💾 内存管理（7个工具）

<table> <tr> <th>工具</th> <th>描述</th> </tr> <tr> <td><code>memory_save</code></td> <td>使用标签、路径和重要性级别存储重要的项目知识</td> </tr> <tr> <td><code>memory_search</code></td> <td>智能语义搜索，带调试模式和路径匹配</td> </tr> <tr> <td><code>memory_ask</code></td> <td>关于记忆的自然语言查询</td> </tr> <tr> <td><code>memory_get_recent</code></td> <td>获取最近创建的记忆，带过滤器</td> </tr> <tr> <td><code>memory_get</code></td> <td>通过ID检索特定记忆</td> </tr> <tr> <td><code>memory_get_multiple</code></td> <td>批量检索多条记忆</td> </tr> <tr> <td><code>memory_forget</code></td> <td>通过ID删除记忆</td> </tr> </table>

🔒 安全（1个工具）

<table> <tr> <th>工具</th> <th>描述</th> </tr> <tr> <td><code>security_scan</code></td> <td>保存前扫描文本中的个人身份信息和秘密</td> </tr> </table>

📁 项目管理（3个工具）

<table> <tr> <th>工具</th> <th>描述</th> </tr> <tr> <td><code>project_switch</code></td> <td>在不同项目间切换</td> </tr> <tr> <td><code>project_current</code></td> <td>获取当前活跃项目的详细信息</td> </tr> <tr> <td><code>change_storage_path</code></td> <td>动态更改存储位置，自动迁移数据</td> </tr> </table>

⚙️ 系统（1个工具）

<table> <tr> <th>工具</th> <th>描述</th> </tr> <tr> <td><code>system_status</code></td> <td>获取系统状态和内存统计信息</td> </tr> </table>

📊 工作原理

graph LR
    A[你的代码] --> B[Kratos MCP]
    B --> C{项目检测}
    C --> D[SQLite数据库]
    D --> E[内存存储]
    E --> F[AI工具]
    F --> G[完美的上下文]

🔬 内部机制

  • SQLite + FTS5: 雷达般的全文搜索速度
  • 智能评分: 路径匹配 + 近期 + 重要性
  • 自动检测: 基于Git、package.json或目录结构
  • 安全: 所有数据本地存储，无外部调用
  • 轻量: 仅有4个核心组件，极小的内存占用

📈 性能

<table> <tr> <th>指标</th> <th>值</th> </tr> <tr> <td>上下文开销</td> <td>比v3小64%</td> </tr> <tr> <td>内存检索</td> <td>&lt; 10毫秒</td> </tr> <tr> <td>项目切换</td> <td>&lt; 100毫秒</td> </tr> <tr> <td>存储开销</td> <td>每个项目约2MB</td> </tr> </table>

🗂️ 内存结构

~/.kratos/                       # 默认存储位置
├── projects/
│   ├── project-id-1/
│   │   └── memories.db          # 包含FTS5的SQLite数据库
│   └── project-id-2/
│       └── memories.db
└── global/
    └── global.db                # 共享知识（可选）

新功能v1.6.1: 使用change_storage_path将数据移动到自定义位置，如/opt/kratos或.kratos用于每个项目的存储。

💡 示例用法

// 保存一条记忆
await memory_save({
  summary: "JWT认证实现",
  text: "我们使用httpOnly cookie和刷新令牌...",
  tags: ["认证", "安全"],
  paths: ["src/middleware/auth.ts"],
  importance: 5
});

// 搜索记忆
await memory_search({
  q: "认证",
  k: 5,
  debug: true  // 获取搜索洞察
});

// 提出自然语言问题
await memory_ask({
  question: "我们的认证系统是如何工作的？",
  limit: 10
});

// 更改存储位置
await change_storage_path({
  newPath: "/opt/kratos",
  migrate: true,
  backup: true
});

🎮 实时演示

// 用户: "解释认证系统"
//
// Kratos自动检索：
// ✓ 两周前的JWT实现
// ✓ 上个月的中间件配置
// ✓ 初始设置时的用户模型结构
//
// AI响应: "您的认证使用JWT，并将刷新令牌存储在httpOnly cookie中。中间件在受保护的路由/api/middleware/auth.ts:42处验证令牌..."

🤝 贡献

我们欢迎贡献！请参阅CONTRIBUTING.md了解指南。

# 克隆仓库
git clone https://github.com/ceorkm/kratos-mcp.git

# 安装依赖
npm install

# 构建
npm run build

# 开发模式运行
npm run dev

📄 许可证

MIT © 2025 Kratos MCP 贡献者

🙏 致谢

基于Anthropic的模型上下文协议构建。

灵感来源于使用AI构建生产应用的实际经验。

<div align="center">

为重视时间的开发者打造。

报告Bug • 请求功能 • 文档

</div>