@trishchuk/kimi-mcp-server

Kimi MCP Server

MCP server (stdio) that bridges Claude / Cursor / any MCP client to Moonshot AI's Kimi Code CLI.

Architecture mirrors @trishchuk/codex-mcp-tool — same patterns, adapted to Kimi's flag surface (--print, --quiet, -r, --continue, --add-dir, --mcp-config-file, --config).

Why

Kimi K2.6 (April 2026) is a 1T-parameter MoE open-weight model with native agent-swarm orchestration, 262k context, and SWE-Bench Pro on par with GPT-5.5. Kimi Code CLI is the reference agent harness. This server lets MCP-aware editors call Kimi as a sub-agent without leaving their primary interface.

Install

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

You also need Kimi Code CLI:

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

Then run kimi once and use /login to authenticate via the Kimi Code platform — or set MOONSHOT_API_KEY.

Configure (Claude Desktop / Cursor / Claude Code)

Minimal — working directory is auto-detected from PWD / INIT_CWD / process.cwd(), just like codex-mcp-tool:

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

Pin a specific project root only if your client launches the server from somewhere unrelated:

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

You can also override per call via the workingDir argument on ask-kimi, or let the server infer it from @path/to/file references in the prompt — same priority chain as codex-mcp-tool: workingDir arg → KIMI_MCP_CWD → PWD → INIT_CWD → @path inference → process.cwd().

Tools

Tool	What it does
ask-kimi	Main entry — file analysis (@path), session resume, MCP passthrough
brainstorm	Structured ideation (divergent / convergent / SCAMPER / design-thinking / lateral / auto)
batch-kimi	Sequential or parallel atomic tasks with priority, stop-on-error, structured report
review-changes	Code review of working tree / branch diff / specific commit (collects git diff and prompts Kimi)
list-sessions	List, delete, or clear active conversation sessions
health	Diagnose Kimi CLI installation, auth, and session state
ping / Help / version	Smoke tests + help passthrough

ask-kimi highlights

• prompt — supports @path/to/file to drop file context (Kimi reads via working dir).
• model — overrides default_model at runtime via --config. Known: kimi-for-coding, kimi-k2-6, kimi-k2-thinking-turbo, kimi-k2-5, kimi-latest.
• thinking — toggles thinking mode (writes default_thinking into runtime config).
• outputFormat — text (default) or stream-json (JSONL of assistant + tool messages, parsed transparently).
• responseMode — clean (default; final assistant text only) or full (tool calls + stderr log + final).
• sessionId — workspace-isolated session ID (md5 of repo:head:path). The server tracks the native Kimi session ID returned by the CLI and replays it via kimi -r <id>.
• continueLatest — sets --continue (resume the most recent session in the cwd).
• mcpConfigFile — passes --mcp-config-file so Kimi can talk to other MCP servers from inside this process.
• addDirs — repeats --add-dir for multi-root projects.
• yolo / afk — approval shortcuts (print mode auto-approves anyway, but useful for documentation/logging).

CLI compatibility

Feature	Kimi CLI
Print / non-interactive	--print (required for MCP); --quiet = --print --output-format text --final-message-only
JSON streaming	--output-format=stream-json, --input-format=stream-json
Sessions	--continue, --session <id>, -r <id>
Configuration	--config-file <path>, --config '<json/toml>'
Workspace	spawn cwd + --add-dir <path> (no --cd flag)
MCP passthrough	--mcp-config-file or kimi mcp add
Exit codes	0 ok, 1 fatal, 75 retryable transient

Environment

Var	Default	Purpose
KIMI_MCP_CWD	—	Override working directory for every tool call
KIMI_SESSION_TTL_MS	86400000 (24h)	Session expiration
KIMI_MAX_SESSIONS	50	Max concurrent sessions
MOONSHOT_API_KEY	—	Forwarded to Kimi CLI for unattended auth

Development

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

License

MIT — Taras Trishchuk