@adhdev/ mcp- 服务器
一个 MCP 磁共振 显示运行的 stdio 服务器 阿多德耶夫 作为工具的代理会话.
ADHDev在你的机器上监督AI编码代理——CLI代理(Claude Code,Codex CLI等)和IDE副驾驶. 这个软件包让一个 MCP 客户端驱动监管: 列出实时会话, 读取代理正在做的事情, 回答一个批准提示, 它被封锁, 并检查它正在工作的工作空间 .
它和已经运行在你的机器上的 ADHDev 守护进程说话了 它是该守护进程的一个客户端,而不是一个独立的服务——先启动守护进程.
安装
服务器由主 CLI 包:
adhdev mcp
直接包入点(相容性 bin, 同一服务器) :
npx @adhdev/mcp-server
或者在全球安装软件包; 二进制是 adhdev-mcp数字 :
npm install -g @adhdev/mcp-server
它会说MCP优于stdio,所以通常是由MCP客户端启动,而不是由手来运行.
连接客户端
将您的MCP客户端指向包装或二进制. 例如:
{
"mcpServers": {
"adhdev": {
"command": "adhdev",
"args": ["mcp", "--mode", "local"]
}
}
}
以 Codex 注册 :
codex mcp add adhdev -- adhdev mcp
运行 adhdev mcp --help (或 adhdev-mcp --help) 为正旗列表.
运输
这个 --mode 旗下选择要交谈的守护进程 。 它是一种运输选择,独立于工具集发布.
| 模式 | 会谈 | 默认端口 |
|---|---|---|
local | 独立守护进程( O)adhdev standalone(中文(简体) ) | 第3847号 |
ipc | Cloud 守护进程的地方 IPC (adhdev daemon(中文(简体) ) | 19222(表)/19223(审查) |
IPC端口出自守护进程放行道,因此不需要告诉预览协调员它自己的守护进程在哪个端口上.
默认为 local。以 --port,并提供一个单独的密码 --password 或者说 ADHDEV_PASSWORD。 。 。 . ADHDEV_MCP_TRANSPORT 从环境设置模式.
如果守护进程无法到达,服务器在启动时会以它所期望的守护进程命名消息而退出——它不会产生一个死路运输.
工具集
哪些工具发布取决于服务器的启动方式 。 这三套是因设计而脱节的,而不仅仅是惯例.
标准(默认)——19个工具
直接监督一台机器上的代理会议.
- 检查 —— 说
list_daemons, (中文(简体) ),list_sessions, (中文(简体) ),check_pending, (中文(简体) ),read_chat, (中文(简体) ),read_chat_debug, (中文(简体) ),spec_debug, (中文(简体) ),screenshot(仅当地模式) - 控制权 —— 说
launch_session, (中文(简体) ),stop_session, (中文(简体) ),send_chat, (中文(简体) ),approve - 图形 —— 说
git_status, (中文(简体) ),git_log, (中文(简体) ),git_diff, (中文(简体) ),git_checkpoint, (中文(简体) ),git_push - 网状靴子 —— 说
mesh_create(数量)mode: "plan"是只读的登机策划者)mesh_add_node。在这里被曝光正是因为这里是无mesh - yet上下文:没有已有的网格代号,网格模式拒绝开始.
Repo Mesh (英语:--repo-mesh <id>()——40个工具
协调员表面 Repo 网络,即通过多个机器和代理人下放工作。 也暴露了协调员系统作为MCP资源在 coordinator://system-prompt。 。 。 .
广义:网点和节点状态(mesh_status, (中文(简体) ), mesh_list_nodes, (中文(简体) ), mesh_route_preview,任务调度和队列管理(mesh_enqueue_task, (中文(简体) ), mesh_enqueue_batch, (中文(简体) ), mesh_send_task, (中文(简体) ), mesh_view_queue, (中文(简体) ), mesh_queue_cancel),阅读授权会议(mesh_read_chat, (中文(简体) ), mesh_read_terminal, (中文(简体) ), mesh_read_node_logs),核准(mesh_approve, (中文(简体) ), mesh_answer_question),节点寿命周期(mesh_clone_node, (中文(简体) ), mesh_remove_node),通过炼油厂进行凝聚(mesh_refine_node, (中文(简体) ), mesh_fast_forward_node),任务和持久任务分类账.
在同一对象上行事的工具是一个参数选择的工具—— mesh_node_slots (单位:千美元)action: 清单/提议/设定), mesh_note (单位:千美元)action:记录/忘记),, mesh_config (单位:千美元)kind:精细/变化-影响/网格-json), mesh_init (单位:千美元)mode: init / reinit),, (中文(简体) ), mesh_create (单位:千美元)mode: 创建/计划)和 mesh_cleanup_sessions (单位:千美元)mode,包括: prune_stale_direct) (中文(简体) ). 每个行动只接受自己的论据。 这些名称在2026-09-26年被替换(mesh_record_note, (中文(简体) ), mesh_plan_onboarding,.)以错误命名替换工具和参数来回答. 图表管弦乐工具mesh_graph_view, (中文(简体) ), mesh_graph_gate, (中文(简体) ), mesh_graph_node_patch)于2026-09-30被移除;链式任务与 depends_on 换句话说. mesh_refine_plan 2026-10-08年被撤走(电话: mesh_refine_node 无 execute它的默认干线是相同的计划, mesh_coordinator_prompt_append 当天就用机器拆了 coordinator-prompts/ 文件( 在 repo 中显示一个长期指令) .adhdev/mesh.json coordinator.systemPromptAppend (第2条) mesh_ledger_query 是一个已贬值的别名,其名称是: mesh_task_history 它现在需要的是 kind 编号 : since 编号 : node 过滤器——为一放出.
网格标识也来自 ADHDEV_MESH_ID。 。 。 .
何时 ADHDEV_WORKER_MCP 在目标守护进程(默认)上启用,协调员也获得第41个工具, mesh_notify_worker,将一份紧急备忘录放入一个忙碌的委派工人的邮箱——交给工人的下一个MCP工具响应,而不是打断其转会.
工人(--worker()——6个工具
一个最小的表面 授权 代理服务器 : report_completion, (中文(简体) ), progress_update, (中文(简体) ), peer_context_pull,加上只读 git_status 编号 : git_log 编号 : git_diff。 。 。 .
Worker 模式不发布网格工具,也不发布协调员即时资源. 因此,工人不能自行委托工作——这种限制是不存在的工具,而不是它可能不遵守的指示. --worker 故意覆盖 --repo-mesh,所以一个 repo , 其坚定的配置 携带了网状的id , 无法将一个工人 的协调员表面.
工作模式需要守护进程颁发的证书(ADHDEV_WORKER_SESSION_BIND 或者说 ADHDEV_WORKER_TASK_TOKEN) 在其环境中,在启动时不设一个出口.
工具说明
每个公布的工具都带有四个MCP行为提示—— readOnlyHint, (中文(简体) ), destructiveHint, (中文(简体) ), idempotentHint, (中文(简体) ), openWorldHint ——所以客户可以决定什么是自动运行,什么是先确认.
他们描述了什么是工具 能够 做,而不是它所做的默认。 几种工具(mesh_refine_node, (中文(简体) ), mesh_fast_forward_node, (中文(简体) ), mesh_cleanup_sessions 与 mode: "prune_stale_direct")返回一个计划,除非被明确告知执行,并且仍然被附加了破坏性说明:一个只描述安全默认的提示就是那种会给人伤害的提示.
暗示是建议 实际执行停留在守护进程内——干线默认,明确 execute 旗帜和所有权检查.
安全说明
- 服务器在本地运行并连接到本地守护进程. 它没有打开自己的监听插座; MCP 流量是 studio.
- 独立
local连接在配置时与守护进程密码进行认证. - 工具只达到守护进程已经暴露的内容——它管理的会话,工作空间和网格节点.
客户端配置
Claude 风格的客户端自动导入一个 repo - 本地 .mcp.json。见 自备配置 确切的片段.
发展
npm run build -w packages/mcp-server
npm test -w packages/mcp-server
许可证
AGPL-3.0-或-后传. 见 自由主义。 。 。 .