MCP 서버

ADHDev는 외부 MCP 클라이언트가 ADHDev 세션을 도구로 사용할 수 있도록 MCP stdio 서버를 제공합니다. 이 서버는 @adhdev/mcp-server로 게시되며 메인 클라우드 CLI인 adhdev mcp로도 래핑됩니다.

Claude Desktop 같은 MCP 클라이언트가 활성 ADHDev 세션을 나열하고, 채팅 히스토리를 읽고, 메시지를 보내거나, 대기 중인 프롬프트를 승인하도록 하려면 사용하세요.

모드

모드	MCP 서버가 사용하는 전송	도구
로컬 스탠드얼론	http://localhost:3847 스탠드얼론 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/셀프호스트 표면의 일부입니다. 스탠드얼론 설정 및 인증 세부 사항은 OSS 문서를 참고하세요:

• Self-hosted Setup
• Self-hosted Local API

서버 시작

# 로컬 모드: 실행 중인 스탠드얼론 데몬 필요
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 도구를 사용하려면 mcp_servers 아래 Hermes YAML 설정에 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 — 하나 또는 여러 워크트리 브랜치를 베이스로 수렴합니다 (검증 → 머지 → 푸시 → 정리).
• mesh_refine_plan — 실행하지 않고 수렴 계획을 미리 봅니다.
• mesh_refine_config_schema / mesh_suggest_refine_config / mesh_validate_refine_config — 프로젝트의 refine 설정을 검사, 스캐폴드, 검증합니다.

관련 레퍼런스

• CLI 명령어
• API 키
• REST API