# @adhdev/mcp-server 中文文档

规范地址：https://npmcn.com/package/%40adhdev/mcp-server/

版本：1\.0\.81
npm 元数据更新时间：2026-10-09T16:30:58.848Z
中文译文更新时间：2026-11-06T22:03:45.902Z
软件包许可：AGPL-3\.0-or-later

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adhdev/mcp-server
原文对照：https://npmcn.com/package/%40adhdev/mcp-server/?lang=original
项目主页：https://github.com/vilmire/adhdev#readme
源码仓库：https://github.com/vilmire/adhdev

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：27.1 MB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2026-05-02T14:03:12.700Z
- 最新版本发布：2026-10-09T16:30:58.611Z
- 近 30 天下载量：2283（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：96（近 12 个月 96 个）

## 中文简介

ADHDev MCP 服务器 —— 将IDE 代理显示为 MCP 工具

## 安装

```sh
npm install @adhdev/mcp-server
```

也可以使用：`pnpm add @adhdev/mcp-server`、`yarn add @adhdev/mcp-server`、`bun add @adhdev/mcp-server`

## README

# @adhdev/ mcp- 服务器

一个 [MCP 磁共振](https://modelcontextprotocol.io/) 显示运行的 stdio 服务器 [阿多德耶夫](https://github.com/vilmire/adhdev) 作为工具的代理会话.

ADHDev在你的机器上监督AI编码代理——CLI代理(Claude Code,Codex CLI等)和IDE副驾驶. 这个软件包让一个 MCP 客户端驱动监管: 列出实时会话, 读取代理正在做的事情, 回答一个批准提示, 它被封锁, 并检查它正在工作的工作空间 .

它和已经运行在你的机器上的 ADHDev 守护进程说话了 它是该守护进程的一个客户端,而不是一个独立的服务——先启动守护进程.

## 安装

服务器由主 CLI 包:

```bash
adhdev mcp
```

直接包入点(相容性 bin, 同一服务器) :

```bash
npx @adhdev/mcp-server
```

或者在全球安装软件包; 二进制是 `adhdev-mcp`数字 :

```bash
npm install -g @adhdev/mcp-server
```

它会说MCP优于stdio,所以通常是由MCP客户端启动,而不是由手来运行.

## 连接客户端

将您的MCP客户端指向包装或二进制. 例如:

```json
{
  "mcpServers": {
    "adhdev": {
      "command": "adhdev",
      "args": ["mcp", "--mode", "local"]
    }
  }
}
```

以 Codex 注册 :

```bash
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 网络](https://github.com/vilmire/adhdev/blob/main/docs/guides/REPO_MESH_GUIDE.md),即通过多个机器和代理人下放工作。 也暴露了协调员系统作为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`。见 [自备配置](https://npmcn.com/package/docs/self-hosted/configuration.md) 确切的片段.

## 发展

```bash
npm run build -w packages/mcp-server
npm test -w packages/mcp-server
```

## 许可证

AGPL-3.0-或-后传. 见 [自由主义](https://npmcn.com/package/%40adhdev/mcp-server/LICENSE)。 。 。 .

## 常见问题

### @adhdev/mcp-server 是什么？

ADHDev MCP 服务器 —— 将IDE 代理显示为 MCP 工具

### 如何安装 @adhdev/mcp-server？

在项目目录运行 npm install @adhdev/mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 adhdev-mcp，可以用 npx adhdev-mcp 直接运行。

### @adhdev/mcp-server 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adhdev\_\_mcp-server 是否存在。

### @adhdev/mcp-server 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @adhdev/mcp-server 可以商用吗？

@adhdev/mcp-server 使用 AGPL-3\.0-or-later 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @adhdev/mcp-server 的下载量有多少？

根据 npm 官方下载统计，@adhdev/mcp-server 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,283 次，日均约 76 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adhdev/mcp-server 还在维护吗？

最新版本 1\.0\.81 发布于 2026/10/10（29 天前）；至今共发布 96 个版本，其中过去 12 个月发布了 96 个；首次发布于 2026/05/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。