MCP 서버

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

Claude Desktop 같은 MCP 클라이언트가 활성 ADHDev 세션을 나열하고, 채팅 히스토리를 읽고, 메시지를 보내거나, 대기 중인 프롬프트를 승인하도록 하려면 사용하세요. Mesh 모드에서는 전체 Repo Mesh 코디네이터 툴 표면이 됩니다 — 등록의 전체 흐름은 에이전트 주도 Repo Mesh 셋업을 참고하세요.

모드

모드	MCP 서버가 사용하는 전송	도구
로컬 스탠드얼론	`http://localhost:3847` 스탠드얼론 API	기본 15개 도구 + `screenshot` + Mesh 부트스트랩 3개 도구 (총 19개)
IPC	`localhost:19222`의 클라우드 데몬 로컬 IPC	동일한 기본 15개 도구 + Mesh 부트스트랩 3개 도구, `screenshot` 제외 (총 18개)
Mesh	로컬 또는 IPC + `--repo-mesh <id>`	코디네이터 범위 세트 — 아래 Mesh 도구 참고

로컬 모드는 OSS/셀프호스트 표면의 일부입니다. 스탠드얼론 설정 및 인증 세부 사항은 OSS 문서를 참고하세요:

서버 시작

bash

# 로컬 모드: 실행 중인 스탠드얼론 데몬 필요
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 도구를 사용하려면 mcp_servers 아래 Hermes YAML 설정에 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개를 노출합니다.

세션 및 데몬

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 — 하나 또는 여러 워크트리 브랜치를 베이스로 수렴합니다 (검증 → 머지 → 푸시 → 정리).
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에 더 이상 게시되지 않으므로 클라이언트의 도구 선택 목록에는 나타나지 않지만, 서버는 하위 호환을 위해 한 릴리스 동안 계속 디스패치하며 일치하는 mode로 통합 핸들러에 포워딩합니다. 새로 작성하는 코드는 mesh_refine_config / mesh_change_impact_config를 직접 사용해야 합니다.

MCP 서버 ​

모드 ​

서버 시작 ​

Claude Desktop 설정 ​

Hermes Agent Mesh 설정 ​

표준 모드 도구 ​

Mesh 도구 ​

퇴역된 별칭 ​

관련 레퍼런스 ​

MCP 서버

모드

서버 시작

Claude Desktop 설정

Hermes Agent Mesh 설정

표준 모드 도구

Mesh 도구

퇴역된 별칭

관련 레퍼런스