Ikenga iyke (control bridge)

重要

このリポジトリは移転しました — ここからビルドしないでください

@ikenga/mcp-iyke の開発は ikenga-pkgs モノレポで継続しています。

→ Royalti-io/ikenga-pkgs/packages/mcp/iyke

このリポジトリは 2026 年 5 月 15 日 に最終更新され、現在はアーカイブ済みで読み取り専用です。

クローンした方への重要な情報です。 ここに残されている状態は、最新リリースでも現行バージョンでもありません。package.json では 0.1.2 が宣言されていますが、ソースには、コードがモノレポに戻される前の時期の、移行が一部完了したツールセットが含まれています。このツリーからビルドすると、公開されたことのないものが作成されます。npm からインストールするものには影響しません。

• npm（変更なし、引き続き適切なパッケージです）：@ikenga/mcp-iyke
• Issue と PR： ikenga-pkgs で作成してください。

---

@ikenga/mcp-iyke

Model Context Protocol サーバーです。Ikenga デスクトップアプリの iyke 制御ブリッジ を公開するため、あらゆる MCP クライアント（Claude Code、Cursor、カスタムエージェント）から、開発者がシェルで iyke CLI に入力するのと同じように、実行中の Ikenga セッションを操作できます。

これは何か

Ikenga は、マニフェスト駆動型のパッケージカーネルを備えた Tauri ベースの AI ワークスペースシェルです。アプリの実行中は、ローカルホストの HTTP サーバー（control.json にベアラートークンを格納）を公開し、外部ツールからライブ UI の状態を確認して操作できます。ペインの切り替え、ルートの移動、DOM スナップショットの取得、要素のクリック、ログの読み取り、スクリーンショットの撮影が可能です。

このパッケージは、その HTTP サーバーを MCP でラップし、LLM エージェントからネイティブに利用できるようにします。ツールは iyke CLI のサブコマンドに対応しています。

インストール

Claude Code 経由（推奨）

npm install -g @ikenga/mcp-iyke
claude mcp add iyke -s user -- iyke-mcp

その後は、どの Claude Code セッションからでも、iyke_state、iyke_go、iyke_mode、iyke_open、iyke_split、iyke_focus、iyke_close のほか、実行時の検査ツール（iyke_dom、iyke_logs、iyke_network、iyke_screenshot、iyke_wait、iyke_click、iyke_type、iyke_key、iyke_query_cache、iyke_devtools）、iframe ツール（iyke_iframe_state、iyke_iframe_send）、プロジェクトツール（iyke_project_create、iyke_project_update、iyke_project_list、iyke_project_archive、iyke_project_set_active、iyke_project_get_active）を呼び出せます。

npx 経由（インストール不要）

claude mcp add iyke -s user -- npx -y @ikenga/mcp-iyke

ソースから（コントリビューター向け）

git clone https://github.com/Royalti-io/ikenga-pkg-mcp-iyke.git
cd ikenga-pkg-mcp-iyke
npm install
npm run build

次に、MCP クライアントの接続先として node /path/to/ikenga-pkg-mcp-iyke/dist/index.js を指定してください。

ツール

レイアウトとナビゲーション

ツール	用途
iyke_state	現在のサイドバーモード、フォーカス中のペインのルート、ペインツリー全体を表示します。
iyke_go	フォーカス中のペインを指定したルートパスに移動します。
iyke_mode	サイドバーのアクティビティモードを切り替えます。
iyke_open	フォーカス中のペインに新しいタブ（ルート、ターミナル、チャット、アーティファクト、ミニアプリ）を開きます。
iyke_split	ペインを水平方向または垂直方向に分割します。
iyke_focus	ID または 1 始まりの DFS リーフインデックス（⌃1..⌃6）でペインにフォーカスします。
iyke_close	ペインを閉じます（pane_id を省略した場合はフォーカス中のペイン）。

ランタイムの検査と操作

ツール	目的
iyke_dom	フォーカス中のペインのアクセシビリティツリーのスナップショット（Playwright 形式の参照）。
iyke_logs	実行中の Web ビューから直近 500 件のコンソールログとエラーログを取得します。
iyke_network	直近 100 件の fetch/XHR ネットワークエントリーを、ステータスと所要時間とともに取得します。
iyke_screenshot	ウィンドウまたは特定のペインの PNG スクリーンショットを取得します。
iyke_wait	条件（テキスト／セレクター／参照／消失）が満たされるまで待機します。
iyke_click	参照、セレクター、またはテキストで要素をクリックします。
iyke_type	入力欄／テキストエリア／contenteditable に入力します。
iyke_key	キーの組み合わせ（例：Ctrl+S、Meta+K）を送信します。
iyke_query_cache	フォーカス中のペインの TanStack Query キャッシュをダンプします。
iyke_devtools	Chrome DevTools を開きます（デバッグビルドのみ）。

Iframe のランタイム状態

ツール	目的
iyke_iframe_state	iframe ペインで最後に公開された状態オブジェクトを読み取ります。
iyke_iframe_send	iframe ペインに postMessage を送信します（応答は待ちません）。

プロジェクト

ツール	目的
iyke_project_create	プロジェクトを作成します（slug と表示名。root_path、icon、color、description は任意）。
iyke_project_update	既存のプロジェクトのフィールド（display_name、root_path、icon、color、description、position）を更新します。
iyke_project_list	切り替えメニューの順にプロジェクトを一覧表示します。include_archived=true を指定すると、アーカイブ済みのプロジェクトも表示されます。
iyke_project_archive	プロジェクトを論理削除します。組み込みの Default プロジェクトはアーカイブできません。
iyke_project_set_active	シェルのアクティブなプロジェクトを切り替え、プロジェクトのスコープに応じたクエリを再取得します。
iyke_project_get_active	現在アクティブなプロジェクトを返します。

信頼境界

MCP サーバーは、プラットフォーム固有のアプリローカルデータディレクトリから control.json を読み取ります（macOS では ~/Library/Application Support/app.ikenga/control.json、Linux では $XDG_DATA_HOME/app.ikenga/control.json、Windows では %APPDATA%/app.ikenga/control.json）。control ファイルには以下が含まれます。

• port — アプリ内 HTTP サーバーがリッスンしている localhost のポート
• token — すべてのリクエストで必要となるベアラートークン
• pid — 所有プロセスの PID（古いファイルの検出に使用）

kill -9 によって古い control.json が残された場合、5 分以上経過していれば自動的に削除されます。5 分未満の古いファイルは通知されます（起動処理の競合の可能性があります）。起動中のアプリのファイルを上書きしないためです。

Ikenga デスクトップアプリが実行されていない場合、すべてのツール呼び出しはハングせず、構造化されたエラーを返します。エージェントはそのエラーを読み取り、黙って待機するのではなく、結果を報告します。

MCP サーバーが通信するのは、control.json に記載されたポートの 127.0.0.1 のみで、同じファイルに記載されたベアラートークンを使用します。外部へのネットワーク通信やテレメトリはありません。

互換性

• Ikenga シェル： v1 の control.json スキーマを公開するすべてのバージョン。
• Node.js： ≥ 20。
• Bun： コンパイルなしで実行できます（bun src/index.ts）。
• MCP SDK： @modelcontextprotocol/sdk ^1.23.0。

バージョン管理

このパッケージはSemVer 2.0.0に準拠しています。メジャーバージョンの更新では、MCP ツール名や引数の形式が変更される場合があります。マイナーバージョンの更新では、新しいツールの追加や互換性を損なわない改善を行い、パッチバージョンの更新ではバグを修正します。

iyke HTTP プロトコルのバージョン（アプリ内サーバーの API サーフェス）は独立しており、control.json の schema_version: 1 で指定されています。このパッケージが現在サポートしているのはプロトコル v1 のみです。

貢献

貢献を歓迎します。セットアップ、規約、DCO についてはCONTRIBUTING.mdをご覧ください。貢献することで、貢献内容が Apache 2.0（リポジトリと同じライセンス）に基づいてライセンスされることに同意したものとみなされます。

バグや機能のリクエストについては、issueを作成してください。 セキュリティに関する問題については、SECURITY.mdをご覧ください。公開 issue は作成しないでください。

ライセンス

Apache License 2.0 — Copyright (c) 2026 Royalti, Inc.

関連リンク

• Ikenga shell — このパッケージが操作するデスクトップアプリです。
• @ikenga/contract — 共有マニフェストと iyke ランタイム定数です。
• Model Context Protocol — このサーバーが使用するプロトコルです。