Kimi MCP Server

Kimi MCP Server

MCP 服务（stdio），可将 Claude / Cursor / 任意 MCP 客户端连接到 Moonshot AI 的 Kimi Code CLI。

架构与 @trishchuk/codex-mcp-tool 类似，采用相同模式，并针对 Kimi 的参数选项（--print、--quiet、-r、--continue、--add-dir、--mcp-config-file、--config）进行了调整。

为什么使用

Kimi K2.6（2026 年 4 月）是一款拥有 1T 参数的 MoE 开源权重模型，原生支持 Agent 群组编排，具有 262k 上下文，在 SWE-Bench Pro 上表现与 GPT-5.5 相当。Kimi Code CLI 是其参考 Agent 框架。该服务让支持 MCP 的编辑器可以将 Kimi 作为子 Agent 调用，而无需离开主要界面。

安装

npm install -g @trishchuk/kimi-mcp-server

你还需要安装 Kimi Code CLI：

curl -LsSf https://code.kimi.com/install.sh | bash
# OR
uv tool install --python 3.13 kimi-cli

然后运行一次 kimi，使用 /login 通过 Kimi Code 平台进行身份验证，或设置 MOONSHOT_API_KEY。

配置（Claude Desktop / Cursor / Claude Code）

最简配置——工作目录会像 codex-mcp-tool 一样，从 PWD / INIT_CWD / process.cwd() 自动检测：

{
  "mcpServers": {
    "kimi": {
      "command": "kimi-mcp"
    }
  }
}

仅当客户端从无关位置启动服务时，才需要指定特定的项目根目录：

{
  "mcpServers": {
    "kimi": {
      "command": "kimi-mcp",
      "env": { "KIMI_MCP_CWD": "/absolute/path/to/your/project" }
    }
  }
}

你也可以通过 ask-kimi 的 workingDir 参数按调用覆盖工作目录，或者让服务根据提示词中的 @path/to/file 引用推断工作目录——优先级顺序与 codex-mcp-tool 相同：workingDir 参数 → KIMI_MCP_CWD → PWD → INIT_CWD → @path 推断 → process.cwd()。

工具

工具	功能
ask-kimi	主入口——文件分析（@path）、会话恢复、MCP 透传
brainstorm	结构化构思（发散式 / 收敛式 / SCAMPER / 设计思维 / 横向思维 / 自动）
batch-kimi	按优先级顺序或并行执行原子任务，支持出错时停止并生成结构化报告
review-changes	审查工作树 / 分支差异 / 指定提交的代码（收集 git diff 并向 Kimi 提示）
list-sessions	列出、删除或清空活跃对话会话
health	诊断 Kimi CLI 安装、身份验证和会话状态
ping / Help / version	冒烟测试 + 帮助透传

ask-kimi 功能亮点

• prompt — 支持使用 @path/to/file 添加文件上下文（Kimi 会通过工作目录读取文件）。
• model — 通过 --config 在运行时覆盖 default_model。已知选项：kimi-for-coding、kimi-k2-6、kimi-k2-thinking-turbo、kimi-k2-5、kimi-latest。
• thinking — 切换思考模式（将 default_thinking 写入运行时配置）。
• outputFormat — text（默认）或 stream-json（助手 + 工具消息的 JSONL，会透明解析）。
• responseMode — clean（默认；仅返回最终助手文本）或 full（工具调用 + stderr 日志 + 最终回复）。
• sessionId — 按工作区隔离的会话 ID（仓库:分支:路径的 md5）。服务会跟踪 CLI 返回的原生 Kimi 会话 ID，并通过 kimi -r <id> 恢复会话。
• continueLatest — 设置 --continue（在当前工作目录中恢复最近的会话）。
• mcpConfigFile — 传入 --mcp-config-file，以便 Kimi 在此进程中与其他 MCP 服务通信。
• addDirs — 对多根项目重复使用 --add-dir。
• yolo / afk — 审批快捷选项（打印模式会自动批准，但仍适用于文档和日志记录）。

CLI 兼容性

功能	Kimi CLI
打印／非交互模式	--print（MCP 必需）；--quiet = --print --output-format text --final-message-only
JSON 流式传输	--output-format=stream-json、--input-format=stream-json
会话	--continue、--session <id>、-r <id>
配置	--config-file <path>、--config '<json/toml>'
工作区	启动时的 cwd + --add-dir <path>（没有 --cd 标志）
MCP 直通	--mcp-config-file 或 kimi mcp add
退出代码	0 成功、1 致命错误、75 可重试的临时错误

环境

变量	默认值	用途
KIMI_MCP_CWD	—	为每次工具调用覆盖工作目录
KIMI_SESSION_TTL_MS	86400000（24 小时）	会话过期时间
KIMI_MAX_SESSIONS	50	最大并发会话数
MOONSHOT_API_KEY	—	转发给 Kimi CLI，以便在无人值守时进行身份验证

开发

npm install
npm run build       # tsc → dist/
npm run lint        # tsc --noEmit
node dist/index.js  # smoke run on stdio

许可证

MIT — Taras Trishchuk