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会员福利.快速开始
# 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 全球):
{
"mcpServers": {
"kimi-code": {
"command": "npx",
"args": ["-y", "kimi-mcp-server"]
}
}
}或者从源代码构建:
git clone https://github.com/howardpen9/kimi-code-mcp.git
cd kimi-code-mcp && npm install && npm run build{
"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中,运行:
kimi然后使用 /login (或 /setup)命令:
/login- 选择 基米代码 作为平台
- 您的浏览器打开进行OAuth授权
- 配置会自动保存到
~/.kimi/config.toml
选项2:手动API密钥配置
获取API密钥
- 访问 代码.kimi.com
- 登录→ 设置 → API密钥
- 创建新密钥(以开头
sk-,仅显示一次)
编辑配置文件
nano ~/.kimi/config.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"使用环境变量(出于安全考虑,建议使用)
# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export KIMICODE_API_KEY="sk-your-api-key"然后参考 config.toml:
[providers.kimi-code]
type = "kimi"
base_url = "https://api.kimi.com/coding/v1"
api_key = "${KIMICODE_API_KEY}"多提供商配置示例
您可以同时配置Kimi Code和Moonshot:
[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 │
└──────────────┘- 克劳德 接收您的任务→ 决定需要理解代码库
- 克劳德 电话
kimi_analyze通过MCP→ Kimi读取整个代码库(256K上下文,接近零成本) - 基米 返回结构化分析
- 克劳德 对分析进行精确、有针对性的编辑
结果:Claude只在决策和代码编写上花费代币,而不是在读取文件上。
K2.5共同代码审查
Kimi Code由K2.5提供支持,K2.5是一个专为深度代码理解而设计的1T MoE模型。这使得 AI配对回顾:
- Kimi预评价 --256K上下文意味着它可以一次看到整个代码库:安全问题、反模式、死代码、架构问题
- 克劳德盘问 --回顾Kimi的发现,质疑有问题的项目,添加自己的见解
- 两个视角 --不同的模型捕捉不同的东西。一个人错过了什么,另一个人就会发现
使用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一致性检查
- 目标编辑前的预审查(先扫描→ 编辑特定文件)
何时跳过,让克劳德直接阅读:
- 小代码库(\` |按ID恢复特定会话|
| --no-thinking |禁用思维模式|
\[!注意\] 没有kimi analyze子命令。MCP工具命名为kimi_analyze,但底层CLI使用上述标志。使用此语法直接调用Kimi进行调试或脚本编写。
高级设置
对于开发(更改时自动重新编译):
{
"mcpServers": {
"kimi-code": {
"command": "npx",
"args": ["tsx", "/absolute/path/to/kimi-code-mcp/src/index.ts"]
}
}
}npm
发表于 kimi-mcp-server 在npm上。
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 版本历史。
许可证
麻省理工学院
