Skip to content

Model Context Protocol ​

Model Context Protocol (MCP) 是一个开放协议,让 AI 模型可以安全地与外部工具和数据源交互。Kimi Code CLI 支持连接 MCP 服务器,扩展 AI 的能力。

MCP 是什么 ​

MCP 服务器提供「工具」给 AI 使用。例如,一个数据库 MCP 服务器可以提供查询工具,让 AI 能够执行 SQL 查询;一个浏览器 MCP 服务器可以让 AI 控制浏览器进行自动化操作。

Kimi Code CLI 内置了一些工具(文件读写、Shell 命令、网页抓取等),通过 MCP 你可以添加更多工具,比如:

  • 访问特定 API 或数据库
  • 控制浏览器或其他应用
  • 与第三方服务集成(GitHub、Linear、Notion 等)

MCP 服务器管理 ​

使用 kimi mcp 命令管理 MCP 服务器。

添加服务器

添加 HTTP 服务器:

sh
# 基本用法
kimi mcp add --transport http context7 https://mcp.context7.com/mcp

# 带 Header
kimi mcp add --transport http context7 https://mcp.context7.com/mcp \
  --header "CONTEXT7_API_KEY: your-key"

# 使用 OAuth 认证
kimi mcp add --transport http --auth oauth linear https://mcp.linear.app/mcp

添加 stdio 服务器(本地进程):

sh
kimi mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest

列出服务器

sh
kimi mcp list

在 Kimi Code CLI 运行时,也可以输入 /mcp 查看已连接的服务器和加载的工具。

移除服务器

sh
kimi mcp remove context7

OAuth 授权

对于使用 OAuth 的服务器,需要先完成授权:

sh
kimi mcp auth linear

这会打开浏览器完成 OAuth 流程。授权成功后,Kimi Code CLI 会保存 token 供后续使用。

MCP OAuth token 存储在 ~/.kimi/mcp-oauth/。从使用 FastMCP 2.x 的旧版本升级后,旧的 token 缓存不会自动迁移;如果 kimi mcp list 显示某个 OAuth 服务器需要授权,重新运行 kimi mcp auth <name> 即可。

测试服务器

sh
kimi mcp test context7

MCP 配置文件 ​

MCP 服务器配置存储在 ~/.kimi/mcp.json,格式与其他 MCP 客户端兼容:

json
{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "your-key"
      }
    },
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest"],
      "env": {
        "SOME_VAR": "value"
      }
    }
  }
}

临时加载配置

使用 --mcp-config-file 参数可以加载其他位置的配置文件:

sh
kimi --mcp-config-file /path/to/mcp.json

使用 --mcp-config 参数可以直接传入 JSON 配置:

sh
kimi --mcp-config '{"mcpServers": {"test": {"url": "https://..."}}}'

加载状态 ​

MCP 服务器在 Shell UI 启动后异步初始化,不会阻塞界面的使用。Shell 底部状态栏会实时显示连接进度,连接完成后自动切换为就绪状态。Web 界面也会同步显示各服务器的连接状态。

如果配置了多个 MCP 服务器,加载时间可能较长,状态栏的进度指示可以帮助你了解当前连接情况。

安全性 ​

MCP 工具可能会访问和操作外部系统,需要注意安全风险。

审批机制

Kimi Code CLI 对敏感操作(如文件修改、命令执行)会请求用户确认。MCP 工具也遵循同样的审批机制,所有 MCP 工具调用都会弹出确认提示。

提示词注入风险

MCP 工具返回的内容可能包含恶意指令,试图诱导 AI 执行危险操作。Kimi Code CLI 会对工具返回内容进行标记,帮助 AI 区分工具输出和用户指令,但你仍应:

  • 只使用可信来源的 MCP 服务器
  • 检查 AI 提议的操作是否合理
  • 对于高风险操作保持手动审批

注意

在 YOLO 或 AFK 模式下,MCP 工具调用也会被自动批准。仅在完全信任 MCP 服务器时使用这些模式。