kimi代码mcp
英语| 中文说明
连接的MCP服务器 基米代码 (K2.5256K上下文) 克劳德代码 --让克劳德编排,而基米处理繁重的阅读。
Kimi K2.5 sits on the efficiency frontier — near-Claude intelligence at 10x lower cost. kimi.com/code
> [!提示]
> 停止付钱给克劳德阅读文件。 Kimi K2.5以极低的成本提供前沿级代码智能(见上图)。将批量代码库扫描委托给Kimi(256K上下文,接近零成本),让Claude专注于它最擅长的事情——推理、决策和精确的代码编辑。一 kimi_analyze 调用可以替换50+个文件读取。
什么是Kimi代码?
基米代码 是Moonshot AI的AI代码代理,由 化学K2.5 模型(1T MoE,256K上下文)。它跨终端、IDE和CLI工作——自主编写、调试、重构和分析代码。
关键规格:
- 256K令牌上下文 --一次读取整个代码库
- 平行代理产卵 --处理并发任务
- Shell、文件和web访问 --完整的开发工具链
- 安装:
curl -L code.kimi.com/install.sh | bash
> [!警告]
> 需要Kimi Code会员资格。 此MCP服务器在后台调用Kimi CLI,这需要一个活动的 Kimi代码计划。请确保您拥有有效的订阅并已运行 kimi login 使用前。
>
> · 计划 · 价格 · 备注
>
> · 中板 · $0 (7天免费试用) · 然后每月19美元。很适合尝试
> · 稍快 · 39美元/月 · 推荐--更高的每周配额+并发性
> · 快板 · 99美元/月 · 用于日常重型开发
> · 活泼的 · 199美元/月 · 大型代码库的最大配额
>
> 年度账单可节省高达480美元。所有计划包括 Kimi会员福利.
快速开始```bash
1. Install Kimi CLI and log in
curl -L code.kimi.com/install.sh | bash
kimi login
2. Install via npm
npm install -g kimi-mcp-server
添加 `.mcp.json` (项目级或 `~/.claude/mcp.json` 全球):```json
{
"mcpServers": {
"kimi-code": {
"command": "npx",
"args": ["-y", "kimi-mcp-server"]
}
}
}
或者从源代码构建:```bash
git clone https://github.com/howardpen9/kimi-code-mcp.git
cd kimi-code-mcp && npm install && npm run build
``````json
{
"mcpServers": {
"kimi-code": {
"command": "node",
"args": ["/absolute/path/to/kimi-code-mcp/dist/index.js"]
}
}
}
跑 `/mcp` 在Claude Code中进行验证——您应该看到 `kimi-code` 7个工具。
## Kimi代码API设置
> \[!注意\]
> **Kimi Code API和Moonshot API是独立的提供商** -它们的API密钥是不可互换的。
有两种方法可以为CLI配置Kimi Code API:
### 选项1:OAuth登录(推荐)
在Kimi Code CLI shell中,运行:```bash
kimi
然后使用 /login (或 /setup)命令:```
/login
1. 选择 **基米代码** 作为平台
1. 您的浏览器打开进行OAuth授权
1. 配置会自动保存到 `~/.kimi/config.toml`
### 选项2:手动API密钥配置
#### 获取API密钥
1. 访问 代码.kimi.com
1. 登录→ **设置** → **API密钥**
1. 创建新密钥(以开头 `sk-`,仅显示一次)
#### 编辑配置文件```bash
nano ~/.kimi/config.toml
添加:```toml
[providers.kimi-code]
type = "kimi"
base_url = "https://api.kimi.com/coding/v1"
api_key = "sk-your-api-key"
[models.kimi-for-coding]
provider = "kimi-code"
model = "kimi-for-coding"
max_context_size = 262144
capabilities = ["thinking"]
[defaults]
model = "kimi-for-coding"
#### 使用环境变量(出于安全考虑,建议使用)```bash
# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export KIMICODE_API_KEY="sk-your-api-key"
然后参考 config.toml:```toml
[providers.kimi-code]
type = "kimi"
base_url = "https://api.kimi.com/coding/v1"
api_key = "${KIMICODE_API_KEY}"
### 多提供商配置示例
您可以同时配置Kimi Code和Moonshot:```toml
[providers.kimi-code]
type = "kimi"
base_url = "https://api.kimi.com/coding/v1"
api_key = "${KIMICODE_API_KEY}"
[providers.moonshot-cn]
type = "kimi"
base_url = "https://api.moonshot.cn/v1"
api_key = "${MOONSHOT_API_KEY}"
[models.kimi-for-coding]
provider = "kimi-code"
model = "kimi-for-coding"
max_context_size = 262144
capabilities = ["thinking"]
[models.kimi-k2]
provider = "moonshot-cn"
model = "kimi-k2-0905-preview"
max_context_size = 256000
capabilities = ["thinking"]
[defaults]
model = "kimi-for-coding"
随时通过以下方式切换型号 /model 或 /model kimi-k2 在CLI中。
Kimi Code vs Moonshot
| 功能 | 基米代码 | 登月计划 |
|---|---|---|
| 焦点 | 针对编码进行了优化 | 通用聊天 |
| 端点 | api.kimi.com/coding/v1 |
api.moonshot.cn/v1 |
| API密钥 | 单独-适用于 代码.kimi.com | 分开 |
| SearchWeb/FetchURL | 内置 | 不可用 |
| 上下文 | 262K | 256K |
你能做什么
告诉克劳德你需要什么。它将自动委托给Kimi:
| 提示 | 发生了什么 |
|---|---|
| “分析此代码库的架构” | Kimi读取所有文件(256K ctx),Claude对报告采取行动 |
| “扫描安全漏洞,然后审查Kimi的发现” | Kimi审计,Claude交叉检查——人工智能配对审查 |
| “映射auth模块的所有依赖关系,然后计划重构” | Kimi构建依赖关系图,Claude计划更改 |
| “回顾回归和边缘案例的最新变化” | Kimi回顾了整个背景(而不仅仅是差异),Claude综合了 |
| “恢复上一次Kimi会话并询问API设计” | Kimi在会话中保留256K个上下文令牌 |
为什么存在
Claude Code功能强大,但价格昂贵。它读取的每个文件都需要令牌。与此同时,许多任务——预审查大型代码库、扫描模式、生成审计报告——都是 高确定性工作 这不需要克劳德的全部推理能力。
> [!重要]
> 成本方程式: Claude阅读50个文件来了解你的架构=昂贵。Kimi通过以下方式读取50个文件 kimi_analyze =接近零成本。然后,Claude对Kimi的结构化报告采取行动=最小令牌。 总节省:在分析繁重的任务上,克劳德代币减少了60-80%。
如何节省代币```
┌─────────────────────────────┐
│ You (the developer) │
└──────────┬──────────────────┘
│ prompt
▼
┌─────────────────────────────┐
│ Claude Code (conductor) │
│ - orchestrates workflow │
│ - makes decisions │
│ - writes & edits code │
└──────┬──────────────┬───────┘
precise │ │ delegate
edits │ │ bulk reading
(tokens) │ │ (FREE)
▼ ▼
┌──────────┐ ┌──────────────┐
│ your │ │ Kimi Code │
│ codebase │ │ (K2.5) │
└──────────┘ │ - 256K ctx │
│ - reads all │
│ - reports │
└──────────────┘
1. **克劳德** 接收您的任务→ 决定需要理解代码库
1. **克劳德** 电话 `kimi_analyze` 通过MCP→ Kimi读取整个代码库(256K上下文,接近零成本)
1. **基米** 返回结构化分析
1. **克劳德** 对分析进行精确、有针对性的编辑
**结果:Claude只在决策和代码编写上花费代币,而不是在读取文件上。**
### K2.5共同代码审查
Kimi Code由K2.5提供支持,K2.5是一个专为深度代码理解而设计的1T MoE模型。这使得 **AI配对回顾**:
1. **Kimi预评价** --256K上下文意味着它可以一次看到整个代码库:安全问题、反模式、死代码、架构问题
1. **克劳德盘问** --回顾Kimi的发现,质疑有问题的项目,添加自己的见解
1. **两个视角** --不同的模型捕捉不同的东西。一个人错过了什么,另一个人就会发现
## 使用Kimi作为代码审阅者
除了即席分析,您还可以使用Kimi作为 **专职评审员** 在您的工作流程中:
### PR审查工作流程```
┌──────────────┐ diff ┌──────────────┐ structured ┌──────────────┐
│ Your PR │ ────────► │ Kimi Code │ findings │ Claude Code │
│ (changes) │ │ (reviewer) │ ────────────►│ (decision) │
└──────────────┘ └──────────────┘ └──────────────┘
持续审计模式
| 何时 | 什么 | 为什么 |
|---|---|---|
| 合并前 | Kimi扫描diff+受影响的模块 | 及早发现回归 |
| 每周 | 全面代码库扫描 | 累积的技术债务 |
| 预发布 | 以安全为重点的审计 | 满怀信心地发货 |
每次审查会议都可以 恢复 (kimi_resume)--Kimi从之前的会话中保留了多达256K个上下文标记,随着时间的推移建立了理解。
Kimi评价如何
| 评论类型 | 为什么Kimi如此优秀 |
|---|---|
| 安全审计 | 256K上下文可以看到完整的攻击面,而不仅仅是孤立的文件 |
| 死代码检测 | 可以跨整个代码库跟踪导入/导出 |
| API一致性 | 同时比较所有端点之间的模式 |
| 依赖关系分析 | 一次性映射完整的依赖关系图 |
| 建筑回顾 | 同时看到森林和树木 |
工具
| 工具 | 描述 | 超时 |
|---|---|---|
kimi_analyze |
深度代码库分析(架构、审计、重构) | 10分钟 |
kimi_query |
快速编程问题,无代码库上下文 | 2分钟 |
kimi_list_sessions |
列出具有元数据的现有Kimi会话 | 即时 |
kimi_resume |
恢复上一个会话(最多256K令牌上下文) | 10分钟 |
kimi_status |
检查CLI安装、版本和身份验证状态 | 即时 |
kimi_cache_status |
查看会话缓存统计信息和性能指标 | 即时 |
kimi_cache_invalidate |
手动使缓存会话无效(按目录或全部) | 即时 |
输出控制参数
kimi_analyze 和 kimi_resume 支持以下参数来控制输出大小:
| 参数 | 值 | 默认值 | 效果 |
|---|---|---|---|
detail_level |
summary / normal / detailed |
normal |
控制提示侧冗长指令 |
max_output_tokens |
编号 | 15000 |
硬上限——如果超过,输出将在干净边界处截断 |
include_thinking |
布尔值 | false |
包括Kimi的内部推理链(额外10-30K代币) |
kimi_query 还支持 max_output_tokens 和 include_thinking.
代币经济学
> [!注意]
> 节省来自 压缩比不是自由阅读。Kimi的订阅成本仍然适用,但关键的好处是减少了昂贵的Claude Code代币消费。```
Without kimi-code-mcp With kimi-code-mcp (normal)
───────────────────── ───────────────────────────
Raw source: 50 files × ~4K = 200K Kimi reads (subscription cost)
Claude reads: 200K tokens 5-15K token report
Claude token cost: $$$ $
**压缩比 `detail_level`:**
|级别|压缩|输出大小|等效源|最佳|
|-------|------------|-------------|-------------------|----------|
| `summary` |40-100x|~2-5K令牌|~8-20K字符/~200-500行代码|快速定位,文件清单|
| `normal` |15-40x|~5-15K令牌|~20-60K字符/~500-1500行代码|架构审查,依赖关系映射|
| `detailed` |5-15x|~15-40K令牌|~60-160K字符/~1500-4000行代码|使用代码片段进行安全审计|
**当储蓄发生时:**
- 大型代码库(50+个文件)——架构理解、跨文件扫描
- 安全审计、死代码检测、API一致性检查
- 目标编辑前的预审查(先扫描→ 编辑特定文件)
**何时跳过,让克劳德直接阅读:**
- 小代码库(\<10个文件)-直接读取更快
- 单文件修改——Claude的内置文件读取就足够了
- 当你需要每一行代码时-- `detailed` 产出接近原始阅读成本
## 运作原理```
┌──────────────┐ stdio/MCP ┌──────────────┐ subprocess ┌──────────────┐
│ Claude Code │ ◄──────────► │ kimi-code-mcp│ ────────────► │ Kimi CLI │
│ (conductor) │ │ (MCP server) │ │ (K2.5, 256K) │
└──────────────┘ └──────────────┘ └──────────────┘
- Claude Code调用MCP工具(例如。,
kimi_analyze) - 此服务器生成
kimi带有提示和代码库路径的CLI - Kimi自主读取文件,分析代码(最多256K个令牌)
- 结果从Kimi的JSON输出中解析出来,并返回给Claude Code
- 克劳德对结构化结果采取行动——编辑、计划或进一步分析
CLI调用参考
MCP服务器在非交互式(打印)模式下调用Kimi CLI:```bash
kimi --work-dir --print -p ""
|标志|目的|
|------|---------|
| `--print` |非交互模式——输出结果和退出(子流程使用所需)|
| `-p` / `--prompt` |直接传递提示(绕过交互式shell)|
| `--work-dir` / `-w` |设置代码库根目录|
| `-S ` |按ID恢复特定会话|
| `--no-thinking` |禁用思维模式|
> \[!注意\]
> 没有 `kimi analyze` 子命令。MCP工具命名为 `kimi_analyze`,但底层CLI使用上述标志。使用此语法直接调用Kimi进行调试或脚本编写。
## 高级设置
对于开发(更改时自动重新编译):```json
{
"mcpServers": {
"kimi-code": {
"command": "npx",
"args": ["tsx", "/absolute/path/to/kimi-code-mcp/src/index.ts"]
}
}
}
npm
发表于 kimi-mcp-server 在npm上。```bash
npx kimi-mcp-server # run directly
npm install -g kimi-mcp-server # install globally
## 项目结构```
src/
├── index.ts # MCP server setup, tool definitions
├── kimi-runner.ts # Spawns kimi CLI, parses output, handles timeouts
└── session-reader.ts # Reads Kimi session metadata from ~/.kimi/
贡献
看 贡献.md 作为指导方针。
更新日志
看 更改日志.md 版本历史。
许可证
麻省理工学院
