Kimi MCP Server について
Kimi MCP Serverは、MCPクライアントをMoonshot AIのKimi Code CLIに接続し、エディターからKimiをサブエージェントとして利用できるようにします。コードレビュー、ファイル分析、セッション管理、構造化ブレインストーミングのツールを提供します。
主な機能
- 01MCP経由のKimi CLI呼び出し
- 02ファイル分析とコードレビュー
- 03セッションの再開と管理
- 04逐次または並列の一括タスク
- 05構造化ブレインストーミングモード
- 06作業ディレクトリの設定
活用シーン
- 01エディターからブランチ差分をレビュー
- 02Kimiによるプロジェクトファイル分析
- 03ワークスペースの会話を再開
- 04複数のコーディングタスクを一括実行
MCP 対応
stdio MCPサーバーはKimi Code CLIを呼び出すツールを提供します。MCP設定ファイルをKimiに渡し、他のMCPサーバーへアクセスさせることもできます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @trishchuk/kimi-mcp-serverKIMI_MCP_CWDOverride working directory for all tool callsKIMI_SESSION_TTL_MSSession time-to-live in milliseconds (default: 86400000 = 24h)KIMI_MAX_SESSIONSMaximum concurrent sessions (default: 50)MOONSHOT_API_KEYシークレットForwarded to Kimi CLI for unattended auth. Leave unset to use OAuth (run `kimi /login` once).ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
14掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| cd | string | いいえ | 作業ディレクトリ |
| afk | boolean | いいえ | --afk:キーボードから離れた状態のモードで自動承認します(プリントモードでは暗黙的に有効)。 |
| plan | boolean | いいえ | 計画モード(--plan)で開始します。より充実した計画を立てるには、plan-kimi ツールを優先してください。 |
| yolo | boolean | いいえ | ⚠️ --yolo:すべてを自動承認します(危険、ファイルへの完全なアクセス権があります)。 |
| agent | enum | いいえ | 使用する組み込みエージェント仕様(--agent)。「default」または「okabe」。default | okabe |
| model | string | いいえ | 任意のモデル上書き。既知のモデル:kimi-for-coding、kimi-k2-6、kimi-k2-6-turbo、kimi-k2-thinking-turbo、kimi-k2-5、kimi-latest。省略した場合は、Kimi CLI のデフォルト設定(~/.kimi/config.toml)を使用します。 |
| quiet | boolean | いいえ | --quiet を使用します(--print --output-format text --final-message-only と同等)。 |
| config | any | いいえ | 設定の上書き。--config で文字列(JSON/TOML)またはオブジェクトを渡します。 |
| dryRun | boolean | いいえ | 解決済みの CLI argv を JSON 形式で返し、Kimi は起動しません。 |
| prompt | string | はい | タスクまたは質問。@ を使ってファイルを含めます(例:'@largefile.ts explain')。 |
| addDirs | array | いいえ | 追加の書き込み可能なディレクトリ(--add-dir、複数回指定可能)。 |
| timeout | number | いいえ | 最大実行時間(ミリ秒、任意) |
| thinking | boolean | いいえ | 思考モードを切り替えます(設定の default_thinking を上書き)。 |
| agentFile | string | いいえ | カスタムエージェント仕様ファイル(--agent-file)。 |
| finalOnly | boolean | いいえ | --final-message-only を追加し、中間のツール呼び出し出力をスキップします。デフォルト:true。 |
| sessionId | string | いいえ | 会話の継続性を保つための内部セッション ID(ワークスペースごとに分離)。 |
| configFile | string | いいえ | 設定ファイルのパス(TOML または JSON)。 |
| skillsDirs | array | いいえ | カスタムスキルディレクトリ(--skills-dir、複数回指定可能)。デフォルトの検出を上書きします。 |
| workingDir | string | いいえ | 実行用の作業ディレクトリ(cd の別名) |
| outputFormat | enum | いいえ | Kimi --output-format。"text"(簡潔な応答のデフォルト)または "stream-json"(assistant と tool のメッセージを含む JSONL)。text | stream-json |
| resetSession | boolean | いいえ | 実行前にセッションコンテキストをクリアします。新しい会話を開始します。 |
| responseMode | enum | いいえ | 応答の詳細度:"clean" は最終回答のみを返し(デフォルト)、"full" はツール呼び出しと stderr の実行ログを含みます。clean | full |
| mcpConfigFile | string | いいえ | `mcpServers` を含む MCP 設定ファイルのパス(--mcp-config-file で渡します)。 |
| continueLatest | boolean | いいえ | --continue を使用して cwd で直近の Kimi セッションを再開します。 |
| includeMetadata | boolean | いいえ | 応答にツール呼び出しのメタデータを含めます(stream-json の場合のみ有効)。 |
| maxStepsPerTurn | integer | いいえ | 1 ターン内のステップ数を制限します(--max-steps-per-turn)。 |
| maxRalphIterations | integer | いいえ | 初回のターン後に追加で実行する自律イテレーション数(--max-ralph-iterations、-1 = 無制限)。 |
詳細
Kimi MCP Server
Claude/Cursor/あらゆる MCP クライアントを Moonshot AI の Kimi Code CLI に接続する MCP サーバー(stdio)です。
アーキテクチャは @trishchuk/codex-mcp-tool を踏襲し、同じパターンを Kimi のフラグ(--print、--quiet、-r、--continue、--add-dir、--mcp-config-file、--config)に合わせて適用しています。
理由
Kimi K2.6(2026 年 4 月)は、ネイティブのエージェントスウォームオーケストレーション、262k のコンテキスト、GPT-5.5 と同等の SWE-Bench Pro を備えた、1 兆パラメーターの MoE オープンウェイトモデルです。Kimi Code CLI はリファレンスとなるエージェントハーネスです。このサーバーを使うと、MCP 対応エディターから、メインのインターフェースを離れることなく Kimi をサブエージェントとして呼び出せます。
インストール
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(repo:head:path の md5)。サーバーは CLI が返すネイティブの Kimi セッション ID を追跡し、kimi -r <id>で再利用します。continueLatest—--continueを設定します(cwd 内の最新セッションを再開します)。mcpConfigFile—--mcp-config-fileを渡し、このプロセス内から Kimi がほかの MCP サーバーと通信できるようにします。addDirs— 複数ルートのプロジェクト向けに--add-dirを繰り返し指定します。yolo/afk— 承認のショートカットです(print モードでは自動承認されますが、ドキュメントやログで役立ちます)。
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 (24h) | セッションの有効期限 |
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
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。