让 Claude Code 与 Kimi 无缝协作

⭐ 在GitHub上给我们点星~您的支持对我们意义重大！ 🙏😊

English | 简体中文

---

一、项目简介

在当前 AI 辅助编程生态中，Claude Code 擅长架构设计与全局思考，而 Kimi 在代码生成与细节优化上表现卓越。KimiMCP 作为两者之间的桥梁，通过 MCP 协议让它们优势互补：

• Claude Code：负责需求分析、架构规划、代码重构
• Kimi：负责算法实现、bug 定位、代码审查
• KimiMCP：管理会话上下文，支持多轮对话与并行任务

相比官方 Kimi MCP 实现，KimiMCP 引入了会话持久化、并行执行和推理追踪等企业级特性，让 AI 编程助手之间的协作更加智能高效。KimiMCP 与官方 Kimi MCP 区别一览：

特性	官方版	KimiMCP
基本 Kimi 调用	√	√
多轮对话	×	√
推理详情追踪	×	√
并行任务支持	×	√
错误处理	×	√

---

二、快速开始

0. 前置要求

请确保您已成功安装和配置claude code与kimi两个编程工具。

• Claude Code 安装指南
• Kimi CLI 安装指南

Important

请确保您的claude code版本在v2.0.56以上；kimi cli版本在v0.16.0以上！

请确保您已成功安装uv工具：

• Windows 在Powershell中运行以下命令：

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  

• Linux/macOS 使用curl/wget下载并安装:

  curl -LsSf https://astral.sh/uv/install.sh | sh #使用curl
  
  wget -qO- https://astral.sh/uv/install.sh | sh #使用wget
  

注意，我们极力推荐Windows用户在WSL中运行本项目！

1. 安装步骤

1.1 移除官方 Kimi MCP（如果已安装）。

claude mcp remove kimi

1.2 安装 KimiMCP。

claude mcp add kimi -s user --transport stdio -- uvx --from git+https://github.com/htmambo/kimimcp.git kimimcp

1.3 验证安装。在 终端 中运行：

claude mcp list

Important

如果看到如下描述，说明安装成功！ kimi: uvx --from git+https://github.com/htmambo/kimimcp.git kimimcp - ✓ Connected

1.4 可选择默认允许claude code自动与kimi交互，在~/.claude/settings.json添加 mcp__kimi__kimi allow项

2. 配置claude code提示词（可选）

为使claude code更好完成与kimi的协同工作，我们极力推荐您在 ~/.claude/CLAUDE.md中添加以下内容

展开查看prompt

## Core Instruction for Kimi MCP

在任何时刻，你必须思考当前过程可以如何与kimi进行协作，如何调用Kimi 为你提供的MCP工具作为你客观全面分析的保障。
其中你**务必执行**以下几个步骤：
**1** 在你对用户需求形成初步分析后，将用户需求、初始思路告知kimi，并要求其完善需求分析和实施计划。
**2** 在实施具体编码任务前，**必须向kimi索要代码实现原型（要求kimi仅给出unified diff patch，严禁对代码做任何真实修改）**。在获取代码原型后，你**只能以此为逻辑参考，再次对代码修改进行重写**，形成企业生产级别、可读性极高、可维护性极高的代码后，才能实施具体编程修改任务。
**3** 无论何时，只要完成切实编码行为后，**必须立即使用kimi review代码改动和对应需求完成程度**。
**4** kimi只能给出参考，你**必须有自己的思考，甚至需要对kimi的回答提出置疑**。尽信书则不如无书，你与kimi的最终使命都是达成统一、全面、精准的意见，所以你们必须不断争辩已找到通向真理的唯一途径。


## Kimi Tool Invocation Specification

 1. 工具概述

  kimi MCP 提供了一个工具 `kimi`，用于执行 AI 辅助的编码任务。该工具**通过 MCP 协议调用**，底层使用 `kimi -p <prompt> --output-format stream-json`，无需使用命令行。

  2. 工具参数

  **必选**参数：
  - PROMPT (string): 发送给 kimi 的任务指令
  - cd (Path): kimi 执行任务的工作目录根路径

  可选参数：
  - SESSION_ID (string | null): 用于继续之前的会话以与 kimi 进行多轮交互，默认为 None（开启新会话）
  - return_all_messages (boolean): 是否返回所有原始 stream-json 消息，默认 False

  返回值：
  {
    "success": true,
    "SESSION_ID": "uuid-string",
    "agent_messages": "agent回复的文本内容",
    "all_messages": []  // 仅当 return_all_messages=True 时包含
  }
  或失败时：
  {
    "success": false,
    "error": "错误信息"
  }

  3. 使用方式

  开启新对话：
  - 不传 SESSION_ID 参数（或传 None）
  - 工具会返回新的 SESSION_ID 用于后续对话

  继续之前的对话：
  - 将之前返回的 SESSION_ID 作为参数传入
  - 同一会话的上下文会被保留

  4. 调用规范

  **必须遵守**：
  - 每次调用 kimi 工具时，必须保存返回的 SESSION_ID，以便后续继续对话
  - cd 参数必须指向存在的目录，否则会返回明确的错误信息
  - 当前 Kimi CLI 的 prompt 模式不会执行命令或修改文件；如需代码原型，要求 kimi 仅给出 unified diff patch 作为参考

  推荐用法：
  - 如需详细追踪 kimi 的推理过程和工具调用，设置 return_all_messages=True
  - 对于精准定位、debug、代码原型快速编写等任务，优先使用 kimi 工具

  5. 注意事项

  - 会话管理：始终追踪 SESSION_ID，避免会话混乱
  - 工作目录：确保 cd 参数指向正确且存在的目录
  - 错误处理：检查返回值的 success 字段，处理可能的错误

---

三、工具说明

点击查看kimi工具参数说明

参数	类型	必填	默认值	说明
PROMPT	str	✅	-	发送给 Kimi 的任务指令
cd	Path	✅	-	Kimi 工作目录根路径
SESSION_ID	str | None	❌	None	会话 ID（None 则开启新会话）
return_all_messages	bool	❌	False	是否返回所有原始 stream-json 消息

点击查看kimi工具返回值结构

成功时：

{
  "success": true,
  "SESSION_ID": "550e8400-e29b-41d4-a716-446655440000",
  "agent_messages": "Kimi 的回复内容...",
  "all_messages": [...]  // 仅当 return_all_messages=True 时包含
}

失败时：

{
  "success": false,
  "error": "错误信息描述"
}

---

四、FAQ

Q1: 是否需要额外付费？

KimiMCP 本身完全免费开源，无需任何额外付费！

Q2: 并行调用会冲突吗？

不会。每个调用使用独立的 SESSION_ID，完全隔离。

---

🤝 贡献指南

我们欢迎所有形式的贡献！

开发环境配置

# 克隆仓库
git clone https://github.com/GuDaStudio/kimimcp.git
cd kimimcp

# 安装依赖
uv sync

提交规范

• 遵循 Conventional Commits
• 提交测试用例
• 更新文档

---

📄 许可证

本项目采用 MIT License 开源协议。 Copyright (c) 2025 guda.studio

---

用 🌟 为本项目助力~