MCP サーバー

ADHDev は、外部の MCP クライアントが ADHDev セッションをツールとして使えるように、MCP stdio サーバーを提供します。このサーバーは @adhdev/mcp-server として公開されており、メインのクラウド CLI からは adhdev mcp としてもラップされています。

Claude Desktop のような MCP クライアントに、アクティブな ADHDev セッションを一覧表示させたり、チャット履歴を読ませたり、メッセージを送らせたり、待機中のプロンプトを承認させたりしたいときに使ってください。Mesh モードでは、フルの Repo Mesh コーディネーターツールサーフェスになります。

モード

モード	MCP サーバーが使用するトランスポート	ツール
ローカル standalone	`http://localhost:3847` standalone API	基本 15 ツール + `screenshot` + Mesh ブートストラップ 3 ツール（合計 19）
IPC	`localhost:19222` のクラウドデーモンローカル IPC	同じ基本 15 ツール + Mesh ブートストラップ 3 ツール、`screenshot` を除く（合計 18）
Mesh	ローカルまたは IPC + `--repo-mesh <id>`	コーディネータースコープのセット — 下記の Mesh ツールを参照

ローカルモードは OSS/セルフホストサーフェスの一部です。standalone のセットアップと認証の詳細については、OSS ドキュメントを参照してください:

サーバーの起動

bash

# Local mode: requires a running standalone daemon
adhdev mcp
adhdev mcp --port 4000
adhdev mcp --password my-standalone-password

OSS パッケージを直接実行することもできます:

bash

npx @adhdev/mcp-server
npx @adhdev/mcp-server --mode ipc --repo-mesh mesh_abc123

環境変数もサポートされています:

bash

ADHDEV_PASSWORD=my-standalone-password adhdev mcp
ADHDEV_MESH_ID=mesh_abc123 adhdev mcp

Claude Desktop の設定

json

{
  "mcpServers": {
    "adhdev": {
      "command": "adhdev",
      "args": ["mcp"]
    }
  }
}

Mesh モード（コーディネータースコープのツール）:

json

{
  "mcpServers": {
    "adhdev-mesh": {
      "command": "adhdev",
      "args": ["mcp", "--mode", "ipc", "--repo-mesh", "mesh_abc123"]
    }
  }
}

Hermes Agent の Mesh 設定

Hermes Agent は、リポジトリローカルの .mcp.json を自動的にインポートしません。Hermes から Repo Mesh ツールを使うには、Hermes の YAML 設定の mcp_servers 以下に Mesh サーバーを追加し、その後新しい Hermes セッションを開始してください。

Hermes 設定ファイルを探す:

bash

hermes config path

Mesh サーバーのエントリを追加する:

yaml

mcp_servers:
  adhdev-mesh:
    command: adhdev
    args:
      - mcp
      - --mode
      - ipc
      - --repo-mesh
      - mesh_abc123
    enabled: true

設定を保存した後、Hermes を終了して再起動してください。MCP ツールは Hermes セッションが開始されるときに検出されるため、すでに実行中のセッションでは新しい Mesh サーバーが見えないことがあります。

標準モードのツール

標準モード（--repo-mesh なし）は、直接セッション制御のサーフェスに加えて、Mesh がまだ存在しない状況で MCP のみのエージェントが先に Mesh を作成できるようにする、3 つの Mesh ブートストラップツールを公開します。

セッションとデーモン

list_daemons — 接続されたデーモンの ID を報告します。
list_sessions — デーモン上の利用可能なセッションを検出します。
launch_session / stop_session — CLI/IDE エージェントのライフサイクルを管理します。
check_pending — 承認待ちのセッションを一覧表示します。

チャットと承認

read_chat — 選択したセッションの最近のチャットを読みます。
read_chat_debug — 選択したセッションのチャット状態に関する境界付きデバッグバンドル。
spec_debug — プロバイダースペック解析用のデバッグヘルパー。
send_chat — 選択したセッションにメッセージを送ります。
approve — 承認プロンプトを承認または拒否します。

Git

git_status, git_diff, git_log, git_checkpoint, git_push — ワークスペースの git 操作を管理します。

ローカル専用

screenshot — デーモンを通じて現在の IDE ウィンドウをキャプチャします。P2P/ローカルデーモンへのアクセスが必要なため、ローカルモードでのみ利用可能で、IPC では利用できません。

Mesh ブートストラップ（ローカル・IPC いずれの標準モードでも利用可能 — まだ Mesh が存在しない場合の経路）

mesh_plan_onboarding — 読み取り専用の dry-run: Mesh を作成/参加した場合に何が起きるかを提案するだけで、何も書き込みません。
mesh_create — 新しい Mesh を作成し、任意で現在のワークスペースを最初のノードとして登録します。
mesh_add_node — 既存のワークスペースを既存の Mesh のノードとして登録します。

Mesh が存在するようになったら、--repo-mesh <mesh_id> を付けて MCP サーバーを再登録し、Mesh モードに切り替えることで、下記の完全なコーディネーターツールセットが使えるようになります — Mesh モードはツールサーフェスに追加するのではなく、完全に置き換えます。

Mesh ツール

Mesh ツールは Mesh モード（--repo-mesh）でのみ利用可能です。標準ツールを、コーディネータースコープのツールセットに置き換えます。

名前と個数の SoT

このページはツールをファミリーごとにまとめて紹介する概要です。正確な名前・現在の個数・完全な入力スキーマの権威あるリストは、oss/packages/mcp-server/src/tools/mesh-tool-schemas.ts の ALL_MESH_TOOLS です。以下のリストとコードが食い違う場合はコードが正しい — このリストは過去に一度古くなったことがあります。

ステータスと検査

mesh_status — 集約スナップショット: すべてのノードのヘルス、git 状態、アクティブなセッション、復旧のヒント、デーモンごとのビルド/陳腐化情報。
mesh_list_nodes — ワークスペースパスと機能を持つノードを一覧表示します。
mesh_read_chat — 委任されたエージェントのチャット履歴を読みます。
mesh_read_debug — 委任されたセッションのための境界付きデバッグバンドル。
mesh_read_terminal — 委任されたセッションの現在の生の PTY ビューポート（今まさに人間が画面で見ているもの）を読みます。
mesh_git_status — ノードワークスペースの git 状態を取得します。
mesh_read_node_logs — ノードのデーモンログファイルを grep します（末尾だけでなくファイル全体）。
mesh_task_history — Mesh 全体のタスクのコンパクトな履歴。
mesh_ledger_query — kind/時間/ノードの軸に沿った読み取り専用の台帳クエリ（タスク軸中心の mesh_task_history を補完）。
mesh_review_inbox — コーディネーターを待っているレビュー/承認保留項目。
mesh_list_pending_approvals — 現在承認判断を待っているすべてのセッションの Mesh 全体リスト。

ディスパッチ・セッション・制御

mesh_send_task — 委任されたエージェントセッションに自然言語のタスクを直接送ります。
mesh_launch_session — Mesh ノードに新しいエージェントセッションを起動します。
mesh_send_keys — 委任されたワーカーセッションに構造化されたキーシーケンスを注入します。
mesh_restart_daemon — Mesh ノードのデーモンを再起動します。
mesh_approve — 委任されたエージェントの保留中のアクションを承認/拒否します。
mesh_answer_question — 委任されたセッションが待機している多肢選択の質問（AskUserQuestion）に答えます。
mesh_checkpoint — ノードワークスペースに git チェックポイントを作成します。
mesh_cleanup_sessions — 古くなった、または孤立した委任セッションを停止/整理します。
mesh_prune_stale_direct — 古い直接ディスパッチのレコードを整理します。

作業キューとミッション

mesh_enqueue_task — アイドルなノードが自律的にクレームするタスクをキューに追加します（target_node_id / prefer_worktree ルーティング、task_mode、mission_id、depends_on をサポート）。
mesh_view_queue — 現在のアクティブな作業の信頼できる情報源（pending/assigned/terminal）。
mesh_queue_cancel / mesh_queue_requeue — キューに入っているタスクをキャンセルまたは再キューします。
mesh_mission_upsert — ミッションの作成/更新（目標のグルーピング + ライフサイクルステータス）。
mesh_mission_list — 目標、ステータス、リアルタイムのタスク進捗（合計/保留/割当済み/完了/失敗）とともにミッションを一覧表示します。
mesh_reconcile_ledger — ピアの境界付きスライスに対してローカルの台帳を照合します。
mesh_requeue_held_events — 復旧可能な保留中のコーディネーターイベントを保留キューに戻します。
mesh_record_note / mesh_forget_note — 将来のコーディネーターが引き継ぐ永続的な運用メモを記録または撤回します。

ブートストラップと設定（Mesh モード。上記の標準モードブートストラップ 3 種とは別物）

mesh_init — 既存の git プロジェクト向けのワンクリックオンボーディング: インストール済みの CLI プロバイダーを検出し、リポジトリの .adhdev/* 設定 3 ファミリー（Refinery、worktree bootstrap、change-impact）を提案します。デフォルトはプレビューで、write: true で適用します。
mesh_reinit — mesh_init と同じですが、すでに初期化済みのリポジトリ向けで、overwrite のデフォルトが true になり、現在値 vs 提案値の diff を返します。
mesh_write_mesh_json_config — マシンローカルの Mesh エントリから、リポジトリにコミットされる .adhdev/mesh.json を書き込みます。
mesh_refine_config — 統合された読み取り専用の Refinery 設定ヘルパー。mode パラメーター（schema / validate / suggest）で操作を選択します。かつて独立していた mesh_refine_config_schema / mesh_validate_refine_config / mesh_suggest_refine_config を置き換えます — 下記の非推奨エイリアスを参照。
mesh_change_impact_config — change-impact 設定向けの同じ統合パターン（mode: schema / validate / suggest）。かつて独立していた mesh_change_impact_config_schema / mesh_validate_change_impact_config / mesh_suggest_change_impact_config を置き換えます。

ノード

mesh_clone_node — ノードを分離された git ワークツリーノードに複製します。
mesh_remove_node — （ワークツリー）ノードを削除し、オプションでセッションを整理します。
mesh_cleanup_worktree_nodes — ブランチがマージ/プッシュ済みであることが証明され、すべての安全除外条件を通過した、収束済みのローカルワークツリーノードの安全な削除を計画（デフォルトは dry-run）または実行します。
mesh_fast_forward_node — デフォルトでは安全に dry-run し、または明示的に実行して、エージェントセッションを起動せずに明確な clean fast-forward を行います。fetch/recheck、merge --ff-only、オプションのサブモジュール更新、事後のステータス検証のみを使用します。

Refinery（ワークツリー → ベースへの収束）

mesh_refine_node / mesh_refine_batch — 1 つまたは複数のワークツリーブランチをベースに収束させます（検証 → マージ → プッシュ → クリーンアップ）。
mesh_refine_plan — 実行せずに収束計画をプレビューします。

MAGI（マルチエージェントクロス検証）

mesh_magi_review — 単一のワーカーを送る代わりに、独立した Mesh エージェントからなる常設パネルで読み取り専用の調査をクロス検証します。
mesh_magi_collect — 以前にディスパッチした MAGI ファンアウトを consensus group id で収集・統合します（mesh_magi_review({ wait:false }) の非同期版に相当）。
mesh_magi_kind_panel_set / mesh_magi_kind_panel_list — この Mesh でタスク種別ごとに構成された MAGI パネルスロットをバインドまたは一覧表示します。

ノードスロット（プロバイダー/モデル/思考レベルのルーティング）

mesh_node_slots_set — プロバイダー/モデル/思考レベルを難易度クラスに紐付けるノードのスロットリストを提案（dry-run）または適用します。
mesh_node_slots_list — ノードの現在のスロットを一覧表示します。

非推奨エイリアス

mesh_refine_config_schema、mesh_suggest_refine_config、mesh_validate_refine_config、およびその change-impact 版（mesh_change_impact_config_schema、mesh_suggest_change_impact_config、mesh_validate_change_impact_config）は、それぞれ mesh_refine_config と mesh_change_impact_config に統合され、mode パラメーターで選択するようになりました。これら 6 つの旧名は tools/list にもはや掲載されないため、クライアントのツール選択には表示されませんが、サーバーは互換性のため 1 リリースの間はディスパッチを継続し、対応する mode で統合ハンドラーに転送します。新しい呼び出し側は mesh_refine_config / mesh_change_impact_config を直接使ってください。

MCP サーバー ​

モード ​

サーバーの起動 ​

Claude Desktop の設定 ​

Hermes Agent の Mesh 設定 ​

標準モードのツール ​

Mesh ツール ​

非推奨エイリアス ​

関連リファレンス ​

MCP サーバー

モード

サーバーの起動

Claude Desktop の設定

Hermes Agent の Mesh 設定

標準モードのツール

Mesh ツール

非推奨エイリアス

関連リファレンス