MCP 服务器

ADHDev 提供了一个 MCP stdio 服务器，让外部 MCP 客户端可以把 ADHDev 会话当作工具使用。该服务器以 @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

启动服务器

# 本地模式：需要一个正在运行的 standalone 守护进程
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 —— 报告已连接守护进程的身份。
• 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，或显式执行一次明确的干净 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