MCP サーバー

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

Claude Desktop のような MCP クライアントに、アクティブな ADHDev セッションを一覧表示させたり、チャット履歴を読ませたり、メッセージを送らせたり、待機中のプロンプトを承認させたりしたいときに使ってください。

モード

モード	MCP サーバーが使用するトランスポート	ツール
ローカル standalone	http://localhost:3847 standalone API	list_daemons, list_sessions, launch_session, stop_session, send_chat, read_chat, read_chat_debug, approve, check_pending, git_status, git_diff, git_log, git_checkpoint, git_push, screenshot, spec_debug（16 ツール）
IPC	localhost:19222 のクラウドデーモンローカル IPC	ローカルモードと同じコマンドルーティングのツールサーフェス
Mesh	ローカルまたは IPC + --repo-mesh <id>	コーディネータースコープのセット（28 ツール）。ステータス/検査: mesh_status, mesh_list_nodes, mesh_read_chat, mesh_read_debug, mesh_git_status, mesh_task_history, mesh_review_inbox。ディスパッチ/セッション: mesh_send_task, mesh_launch_session, mesh_approve, mesh_checkpoint, mesh_cleanup_sessions, mesh_prune_stale_direct。キュー/ミッション: mesh_enqueue_task, mesh_view_queue, mesh_queue_cancel, mesh_queue_requeue, mesh_mission_upsert, mesh_reconcile_ledger。ノード: mesh_clone_node, mesh_remove_node, mesh_fast_forward_node。Refinery: mesh_refine_node, mesh_refine_batch, mesh_refine_plan, mesh_refine_config_schema, mesh_suggest_refine_config, mesh_validate_refine_config

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

• Self-hosted Setup
• Self-hosted Local API

サーバーの起動

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

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

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

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

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

Claude Desktop の設定

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

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

{
  "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 設定ファイルを探す:

hermes config path

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

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

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

ツールに関する注記

• list_daemons — 接続されたデーモンの ID を報告します。
• list_sessions — デーモン上の利用可能なセッションを検出します。
• launch_session と stop_session — CLI/IDE エージェントのライフサイクルを管理します。
• read_chat — 選択したセッションの最近のチャットを読みます。
• send_chat — 選択したセッションにメッセージを送ります。
• approve — 承認プロンプトを承認または拒否します。
• check_pending — 承認待ちのセッションを一覧表示します。
• git_status, git_diff, git_log, git_checkpoint, git_push — ワークスペースの git 操作を管理します。
• screenshot — デーモンを通じて現在の IDE ウィンドウをキャプチャします。

Mesh ツール

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

ステータスと検査

• mesh_status — 集約スナップショット: すべてのノードのヘルス、git 状態、アクティブなセッション（コーディネーター所有）。
• mesh_list_nodes — ワークスペースパスと機能を持つノードを一覧表示します。
• mesh_read_chat — 委任されたエージェントのチャット履歴を読みます。
• mesh_read_debug — 委任されたセッションのための境界付きデバッグバンドル。
• mesh_git_status — ノードワークスペースの git 状態を取得します。
• mesh_task_history — Mesh 全体のタスクのコンパクトな履歴。
• mesh_review_inbox — コーディネーターを待っているレビュー/承認保留項目。

ディスパッチとセッション

• mesh_send_task — 委任されたエージェントセッションに自然言語のタスクを直接送ります。
• mesh_launch_session — Mesh ノードに新しいエージェントセッションを起動します。
• mesh_approve — 委任されたエージェントの保留中のアクションを承認/拒否します。
• 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_reconcile_ledger — ピアの境界付きスライスに対してローカルの台帳を照合します。

ノード

• mesh_clone_node — ノードを分離された git ワークツリーノードに複製します。
• mesh_remove_node — （ワークツリー）ノードを削除し、オプションでセッションを整理します。
• 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 — 実行せずに収束計画をプレビューします。
• mesh_refine_config_schema / mesh_suggest_refine_config / mesh_validate_refine_config — プロジェクトの refine 設定を検査、スキャフォールド、検証します。

関連リファレンス

• CLI コマンド
• API キー
• REST API