Kimi Coding MCP

Kimi Coding MCP 是一个把 Kimi Coding Search / Fetch 接口封装成 MCP 工具的服务，适合部署到服务器后，以远程 MCP 的方式接入你的客户端。

它提供两个工具：

• kimi_search：调用 POST https://api.kimi.com/coding/v1/search
• kimi_fetch：调用 POST https://api.kimi.com/coding/v1/fetch

核心实现是 server.py，容器入口是 Dockerfile。

1. 快速开始

安装依赖：

pip install -r requirements.txt

远程模式启动：

python server.py --transport streamable-http --host 0.0.0.0 --port 8000

默认 MCP 地址：

http://127.0.0.1:8000/mcp

如果你部署在带 HTTPS 的域名上，对外地址通常就是：

https://your-domain.com/mcp

2. 工具说明

kimi_search

输入参数：

{
  "text_query": "食贫道 最新视频 2025 2026",
  "limit": 10,
  "enable_page_crawling": false,
  "timeout_seconds": 30
}

kimi_fetch

输入参数：

{
  "url": "https://search.bilibili.com/all?keyword=食贫道"
}

3. Docker 部署

方式 A：不带代理，直接暴露端口

这种方式适合内网使用、临时测试，或者你已经有其他网关负责对外转发。

构建镜像：

docker build -t kimi-coding-mcp .

单租户模式：

docker run -d \
  --name kimi-coding-mcp \
  -p 8000:8000 \
  -e KIMI_API_KEY=sk-kimi-你的key \
  kimi-coding-mcp

多租户模式：

docker run -d \
  --name kimi-coding-mcp \
  -p 8000:8000 \
  kimi-coding-mcp

部署完成后，对外 MCP 地址通常是：

http://你的服务器IP:8000/mcp

方式 B：带代理，通过 HTTPS 域名访问

这种方式适合公网部署。仓库里已经提供了 compose.yaml 和 Caddyfile。

1. 复制环境变量模板：

cp .env.production.example .env.production

2. 编辑 .env.production

单租户模式：

KIMI_API_KEY=sk-kimi-你的key
APP_DOMAIN=kimi-mcp.example.com

多租户模式：

KIMI_API_KEY=
APP_DOMAIN=kimi-mcp.example.com

3. 确保域名已经解析到服务器公网 IP，并放行 80 和 443

4. 启动：

docker compose up -d --build

部署完成后，对外 MCP 地址通常是：

https://kimi-mcp.example.com/mcp

4. 客户端配置

推荐使用多租户模式，让每个客户端自己携带 Kimi key。

多租户模式：

{
  "mcpServers": {
    "kimi-coding-remote": {
      "type": "streamable_http",
      "url": "https://kimi-mcp.example.com/mcp",
      "headers": {
        "X-Kimi-Api-Key": "sk-kimi-替换成你的key"
      }
    }
  }
}

单租户模式：

{
  "mcpServers": {
    "kimi-coding-remote": {
      "type": "streamable_http",
      "url": "https://kimi-mcp.example.com/mcp"
    }
  }
}

远程模式下，API key 的优先级是：

1. X-Kimi-Api-Key 请求头
2. Authorization: Bearer sk-... 请求头
3. 服务端环境变量 KIMI_API_KEY

5. 环境变量

常用环境变量如下：

KIMI_API_KEY=sk-kimi-你的key
KIMI_BASE_URL=https://api.kimi.com/coding/v1
KIMI_USER_AGENT=KimiCLI/1.24.0
KIMI_MSH_PLATFORM=kimi_cli
KIMI_MSH_VERSION=1.24.0
KIMI_DEVICE_NAME=YOUR-PC
KIMI_DEVICE_MODEL=Windows 11 AMD64
KIMI_OS_VERSION=10.0.26200
KIMI_DEVICE_ID=自定义设备ID
KIMI_LOG_DIR=logs
KIMI_LOG_LEVEL=INFO
KIMI_LOG_MAX_BYTES=5242880
KIMI_LOG_BACKUP_COUNT=3
KIMI_LOG_PREVIEW_BYTES=100
MCP_TRANSPORT=streamable-http
MCP_HOST=0.0.0.0
MCP_PORT=8000
MCP_STREAMABLE_HTTP_PATH=/mcp

如果没有显式设置 KIMI_DEVICE_ID，服务会优先读取 ~/.kimi/device_id；读不到时才会按 device_name 生成一个稳定 UUID。

日志默认写入 logs/server.log，并按大小轮转。日志会记录：

• 调用的 endpoint
• 入参预览（默认最多 100 字节）
• 返回结果预览（默认最多 100 字节）
• 状态码与耗时

为了安全，api_key、authorization、token、secret 等敏感字段会自动脱敏。

本地运行时可以参考 .env.example，带代理的 Docker 部署可以参考 .env.production.example。

6. 本地调试

如果你需要本地调试 stdio 模式，可以直接运行：

python server.py --transport stdio

如果你需要本地验证容器：

docker build -t kimi-coding-mcp .
docker run --rm -p 8000:8000 -e KIMI_API_KEY=sk-kimi-你的key kimi-coding-mcp

7. 说明

• kimi_search 使用 text_query、limit、enable_page_crawling、timeout_seconds 请求搜索接口；如果响应是 JSON，会自动格式化。
• kimi_fetch 使用 url 请求抓取接口，并默认按 Accept: text/markdown 返回文本。