# @aidemd-mcp/server 中文文档 规范地址：https://npmcn.com/package/%40aidemd-mcp/server/ 版本：0\.15\.0 npm 元数据更新时间：2026-10-28T12:18:18.455Z 中文译文更新时间：2026-11-06T14:01:44.491Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40aidemd-mcp/server 原文对照：https://npmcn.com/package/%40aidemd-mcp/server/?lang=original 项目主页：https://github.com/aidemd-mcp/server#readme 源码仓库：https://github.com/aidemd-mcp/server ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.6 MB，428 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：6 个 - 首次发布：2026-04-14T02:18:38.875Z - 最新版本发布：2026-10-28T12:18:17.854Z - 近 30 天下载量：3070（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：50（近 12 个月 50 个） ## 中文简介 通过工具描述和渐进披露工具来教给任何代理人的 MCP 服务器 ## 安装 ```sh npm install @aidemd-mcp/server ``` 也可以使用：`pnpm add @aidemd-mcp/server`、`yarn add @aidemd-mcp/server`、`bun add @aidemd-mcp/server` ## README [![AIDE](https://img.shields.io/badge/AIDE-intent--driven-0D9488?style=flat&logo=markdown&logoColor=white)](https://github.com/aidemd-mcp/server) [![CI](https://github.com/aidemd-mcp/server/actions/workflows/ci.yml/badge.svg)](https://github.com/aidemd-mcp/server/actions/workflows/ci.yml) [![npm version](https://img.shields.io/npm/v/@aidemd-mcp/server.svg)](https://www.npmjs.com/package/@aidemd-mcp/server) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![server MCP server](https://glama.ai/mcp/servers/aidemd-mcp/server/badges/score.svg)](https://glama.ai/mcp/servers/aidemd-mcp/server) [![npm downloads](https://img.shields.io/npm/dm/@aidemd-mcp/server.svg)](https://www.npmjs.com/package/@aidemd-mcp/server) [![TypeScript](https://img.shields.io/badge/TypeScript-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/) [![Discord](https://img.shields.io/discord/1496212051377262692?label=Discord&logo=discord)](https://discord.gg/N4NqMXuvTR) # @ aidemd- mcp/ 服务器 MCP服务器,将意图驱动的开发带给任何AI动力的IDE. 管理 `.aide` 生活在代码旁边的 spec 文件——域名上下文 建筑师计划从, 执行者建设, 和QA验证反对. 学习更多 [帮助.dev](https://aidemd.dev/)。 。 。 . ## 特征 - **全项目范围的发现** 与一个渐进的披露树 表面意图,研究和QA的规格 在你的代码库的每一个级别 - **一个命令项目拖带** 通过 `aide_init` ——电线方法 Docs, 管道命令, 以及这个 MCP 服务器在单一导流中进入您的项目 - **自动命名公约的执行** —— 说 `aide_scaffold` 处理 `.aide` 编号 : `intent.aide` 重命名规则, 这样您就不会创建相冲突的字段 - **警戒管道清理** 通过 `aide_cleanup` ——删除一个已关闭模块的计划,待办事宜仅在每个复选框被检查时才简短,并拒绝准确的打开项目否则 - **健康检查鉴定** 通过 `aide_validate` ——在引起漂移之前,检测出孤儿谱,缺失描述,断开链接,并命名冲突 - **代码回顾** 通过 `aide_inspect` ——返回JSDoc,签名,以及未打开文件的命名符号类型,给予代理第二级逐步披露代码 - **更新漂移探测** 通过 `aide_upgrade` – 将您的项目AIDE方法的文物与犬科版本进行比较,并按类别编写更新 - **运行时脑入点** 通过 `aide_brain` ——按需工具,返回即时可执行的道具,告诉代理 MCP 工具要呼叫哪个,如何到达任何脑后端被接通,而代理不知道是哪个后端 ## 安装 ### 快速启动( Claude 代码) 从您的工程根运行安装器 : ```bash npx -y @aidemd-mcp/server@0.15.0 init ``` 此命令 : - 在全球安装 AIDE MCP 服务器(`npm i -g @aidemd-mcp/server`如果安装失败, 它会这么说, 写什么 - 合并 AIDE MCP 服务器条目 `.mcp.json`,由其全球指挥部发射 `aidemd-mcp` - 将捆绑的大脑配置模板写入 `.aide/config/brain.aide` (大脑位置在 `/aide:brain config` 填充并写出大脑MCP条目) - 将每个管道斜线命令写入 `.claude/commands/aide/` - 安装11个犬类代理 `.claude/agents/aide/` (管道代理人加上 `aide-upgrader`,哪个 `/aide:upgrade` 运行以迁移项目自己的文件)和 `kanban-maintainer` 董事会代理到 `.claude/agents/kanban/` - 安装技能( E)`study-playbook`, (中文(简体) ), `brain`, (中文(简体) ), `aide`, (中文(简体) ), `aide-handoff`, (中文(简体) ), `kanban`, (中文(简体) ), `aide-brain-author`改为: `.claude/skills/` - 安装方法 Docs 中枢 `.aide/docs/` - 写下 `aide-tree` 发射装置到 `.aide/bin/aide-tree.mjs` - 将 AIDE 徽章添加到 `README.md` (如果不在场,则附上) 所有操作都是添加剂——已经存在的文件永远不会被覆盖. 随时可以安全地重新运行. `init` 要求没有脑部位置、路径或符号,并拒绝后端旗帜,例如 `--vault-path`。 。 。 . `--brain ` 选择捆绑的模板(仅限今天) `obsidian`,默认值). 运行后,打开 Claude 代码并运行 `/aide`。在第一次运行时,它向 `/aide:brain config`,填补大脑位置 `.aide/config/brain.aide`将大脑MCP输入通过同步, 并播种大脑。 还有什么 `init` 无法完成 . ### 将大脑同步到Mcp.json 编辑后运行此功能 `.aide/config/brain.aide` 例如,当你更新大脑路径参数时 `mcpServerConfig.args` 或重命名大脑在 `name` 字段 : ```bash aidemd-mcp sync ``` `sync` 读取 `.aide/config/brain.aide`副本 `mcpServerConfig` 逐字记录 `.mcp.json` 固定费用项下 `brain` 键并写入 `name` 字段作为服务器标签。 其他钥匙都在里面 `mcpServers` (包括你的办公室) `aide` 条目和任何个人MCP集成)为左字节-同. 如果有遗产 `obsidian` 键已存在,它在同一字段中被删除。 命令是一能的——运行它两次产生同样的效果 `.mcp.json` 字节和第二个引用指纹 `already in sync` 不接触文件。 退出代码为 `0` 成功(包括无变化案例), `1` 失踪或畸形 `brain.aide` 无效 `.mcp.json`,以及 `2` 打开 `--help`。 。 。 . 更新大脑路径后示例输出 `mcpServerConfig.args`数字 : ``` Read .aide/config/brain.aide Wrote brain MCP entry into .mcp.json command: mcpvault args: [D:/notes/new-brain] Done. ``` ### 手动配置 如果您使用克劳德代码以外的客户端,或者倾向于手动配置,则将服务器条目添加到客户端的MCP配置文件中. #### 克劳德代码 安装一次, 然后注册 : ```bash npm i -g @aidemd-mcp/server claude mcp add aide -- aidemd-mcp ``` 或增加你的项目 `.mcp.json`数字 : ```json { "mcpServers": { "aide": { "command": "aidemd-mcp" } } } ``` > \[注\] 上面的"快起"命令为克洛德代码用户自动处理此操作. #### 克劳德桌面 配置文件位置 : - **马可斯:** `~/Library/Application Support/Claude/claude_desktop_config.json` - **窗口 :** `%APPDATA%\Claude\claude_desktop_config.json` 之后 `npm i -g @aidemd-mcp/server`数字 : ```json { "mcpServers": { "aide": { "command": "aidemd-mcp" } } } ``` > \[注\] Claude Desktop 不继承终端 PATH 。 如果你使用nvm或Homebrew来管理节点, `aidemd-mcp` 可能无法找到。 运行 `which aidemd-mcp` 在终端中获取绝对路径并将其用作上面配置中的命令. Claude Desktop在任何配置改变后需要完全退出并重新打开. #### 光标 添加为 `~/.cursor/mcp.json`数字 : 之后 `npm i -g @aidemd-mcp/server`数字 : ```json { "mcpServers": { "aide": { "command": "aidemd-mcp" } } } ``` #### VS 代码/ 副驾驶 添加为 `.vscode/mcp.json`数字 : 之后 `npm i -g @aidemd-mcp/server`数字 : ```json { "servers": { "aide": { "command": "aidemd-mcp" } } } ``` > \[注\] VS 代码/ 副驾驶使用 `"servers"` 作为根键,不是 `"mcpServers"`。使用错误的根键会使服务器静默地无法加载. #### 风起浪起 添加为 `~/.windsurf/mcp.json`数字 : 之后 `npm i -g @aidemd-mcp/server`数字 : ```json { "mcpServers": { "aide": { "command": "aidemd-mcp" } } } ``` ## 工具 ### 助理( d) 扫描工程为 `.aide` spec文件并返回一个渐进披露树图,显示每个 spec的类型,位置,和摘要. 计划或待办事宜列表带有其状态内含,例如. `[plan: approved]`,并经过审查后将其调整. **输入 :** - `path` (弦,可选):分管钻入. 提供后,反应会以祖先链开口——从根到目标相接的相接意向分界线,每个祖先会显示其描述和相接状态,然后是带有摘要和警告的详细子树. 省略时,返回浅的全项目地图(仅位置和类型). ### 备忘( a) 读取 `.aide` 具有完整上下文的 spec文件,返回文件内容,其分类类型(intent/research/plan/todo),同一目录中的相关 specs,以及内容中找到的链接. **输入 :** - `path` (字符串,需要):通往 `.aide` 要读取的文件. ### 辅助脚手架( s) 创建新 `.aide` 带有自动命名公约执行的 spec 文件. 处理重命名规则: 意图规格为 `.aide` 默认但变为 `intent.aide` 何时 `research.aide` 存在于同一文件夹中; 创建 `research.aide` 自动重命名任何已存在的 `.aide` 改为 `intent.aide`。 。 。 . **输入 :** - `directory` (字符串,要求): 目录 `.aide` 将创建文件. - `type` (字符串,需要):要创建的文件类型. 其中一个: `intent`, (中文(简体) ), `research`, (中文(简体) ), `both`, (中文(简体) ), `todo`, (中文(简体) ), `plan`, (中文(简体) ), `session`。 。 。 . `session` 总是在 `.aide/session.aide`随便 `directory` 说. 它从未覆盖: 已经存在的文件会被跳过并报告 。 开始新的意图 `alignment: unreviewed`; 新计划和待办事宜列表开始 `status: proposed`。 。 。 . ### 辅助清除( a) 取出一个封闭舱的管道电平—— `brief.aide`, (中文(简体) ), `todo.aide` 财务报告和审定财务报表 `plan.aide` - 没有别的了 先决条件在法典中强制执行。 它要删除的每个文件都必须记录关闭状态: `completed` (和每个复选框真正检查)或 `abandoned`; 当检查每个复选框时, 状态存在前的文件 。 还有什么 `proposed` 或者说 `approved` 被拒绝。 A 类 `brief.aide` 仅连同其计划一并删除,而一个被抛弃的计划则随其简短内容一并删除。 没有的地方 `plan.aide`,关闭 `todo.aide` 自动删除。 拒绝会删除任何内容,并将每个未选中的项目及其文件和行命名。 它从不接触意图 规格,代码或 `.aide/session.aide`,它拒绝项目以外的路径。 没有外壳的跨平台,所以清理不需要 `rm` 权限 —— 允许工具的名称. **输入 :** - `path` (字符串,要求): 模块文件夹, 相对于工程根 . - `dryRun` (布尔,可选): 报告哪些东西将被移除, 或哪些块被移除, 不删除任何东西。 只为了检查——真正的呼叫已经安全了. ### 协助前题 读取或更改一个 AIDE 文件的规范前题值, 留下其他的字节不变 。 意向规格 `alignment` (单位:千美元)`unreviewed`, (中文(简体) ), `aligned`, (中文(简体) ), `misaligned`) (中文(简体) ). 计划、简报和待办事宜清单 `status`移动 `proposed` → `approved` → `completed`,或改为 `abandoned`· ; `completed` 财务报告和审定财务报表 `abandoned` 最终, `completed` 需要检查每个项目,并修改 `approved` 文件降回 `proposed`。该工具执行允许的移动并拒绝会话记录、研究规格、非AIDE文件和项目以外的路径。 它从来不决定一个值何时会改变——对接器,QA,用户的认可或丢弃. **输入 :** - `path` (字符串,要求): AIDE 文件,相对于工程根. - `field` (弦,可选): `alignment` 或者说 `status`关闭 `value` 读取. - `value` (弦,可选): 新价值. ### 检查助理( i) 返回 JSDoc 块、 签名和类型, 用于工作空间中的指定函数、 方法、 类、 接口或别名类型 —— 第二级 逐步披露代码。 特工们可以在不打开文件的情况下理解一个符号的合同. **输入 :** - `name` (字符串,需要):符号名可以抬头. - `file` (弦,可选): 将搜索限制为单个文件( 相对于工程根) . ### 辅助( v) 健康检查 `.aide` 工程中的 spec 文件 。 检测到孤儿的规格, 缺少的规格, 命名冲突 (`.aide` 财务报告和审定财务报表 `intent.aide` 在同一个文件夹中),断开的链接,孤行的研究文件,缺失前题描述,无法解析的前题,以及意图规格 `alignment` 缺少或没有已知值. **输入 :** - `path` (字符串,可选):子目录用于验证. 省略时默认整个工程 . ### 助手 info {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}布特时间前提记者 将管弦乐团分支分开返回两个独立领域: `outdated` (一系列过时的 AIDE 文物密钥,比较项目的 `versions.json` 以已发的《古兰经》盟誓 `brain` 联合国 `{ status, name?, hints }` 对象报告项目是否 `brain.aide` 连接到 `.mcp.json`) (中文(简体) ). `brain.status` 已关闭的五级工会: `ok | no-brain-aide | brain-aide-invalid | no-mcp-entry | mcp-drift`,通过比较得出 `.aide/config/brain.aide` 反对 `.mcp.json` ——没有磁盘路径验证. `brain-aide-invalid` 表示文件已存在但无法使用并带有 `fault`: 任意 `missing-sections` (将缺勤的部分命名)或 `malformed` (有原因,也涵盖无法读取的文件). `name` 是用户声明的标签 `brain.aide`; 它没有在 `no-brain-aide` 财务报告和审定财务报表 `brain-aide-invalid`。 。 。 . `/aide:brain config` 两者的恢复 `no-brain-aide` 财务报告和审定财务报表 `brain-aide-invalid`。 。 。 . `hints` 是一系列候选金库位置 管弦乐手在恢复过程中可以浮出水面. **输入 :** (无) ### 辅助大脑( b) 点取入取入取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 需要联系到大脑中层任务时就叫这个——不要在每一个任务上叫这个 `/aide` 脚 启动时的大脑先决条件状态已经由 `aide_info.brain.status`; 开火 `aide_brain` 在靴子上重复了不必要的工作. 回返 `{ status, instructions }` - 正是两个领域。 没有 `backend`,没有 `connector`,没有 `name`。 。 。 . `status` 镜像 `aide_info.brain.status` (单位:千美元)`ok | no-brain-aide | brain-aide-invalid | no-mcp-entry | mcp-drift`) (中文(简体) ). `instructions` 总是不空: 在 `ok` 它是所选部分的逐字记录正文(英文)`orientation` 或者说 `config`,按可选 `kind` 输入) `.aide/config/brain.aide` (没有服务器替换);在故障状态下,它携带补救道具. `no-brain-aide` 财务报告和审定财务报表 `brain-aide-invalid` 双向 `/aide:brain config`· ; `brain-aide-invalid` 由探测器组成 `fault` ——或者缺少所需的部分,名称,或者错误的原因(包括一个存在但无法读取的文件,从未报告为缺席). `no-mcp-entry` 财务报告和审定财务报表 `mcp-drift` 告诉用户与发射机同步运行 `aide` 条目用途`aidemd-mcp sync` 或者说 `npx -y @aidemd-mcp/server@ sync`) (中文(简体) ). **输入 :** (无) ### 辅助init 将AIDE开发环境拖入一个使用导师一次性向导的项目。 第1通电话(无) `category`),返回带有状态和被检测到的框架的每个步骤的摘要。 以后的电话(与 `category`),将该类的所有待决文件写入磁盘并返回清单. **输入 :** - `framework` (弦,可选): 强制特定框架而不是自动检测。 其中一个: `claude`, (中文(简体) ), `cursor`, (中文(简体) ), `windsurf`, (中文(简体) ), `copilot`。 。 。 . - `path` (弦,可选): 自定义工程根路径 。 服务器工作目录的默认值 . - `category` (弦,可选): 全写 `would-create` 并返回一个清单。 其中一个: `framework`, (中文(简体) ), `methodology`, (中文(简体) ), `commands`, (中文(简体) ), `agents`, (中文(简体) ), `skills`, (中文(简体) ), `mcp`, (中文(简体) ), `brain`, (中文(简体) ), `ide`, (中文(简体) ), `readme`. Omit 在第一个呼叫中获得一个只包含元数据的摘要. 辅助 MCP 条目总是启动全局命令 `aidemd-mcp`。一个将创建的辅助条目 `globalPackage`; 未安装时, 代理运行 `installCommand` 在合并条目之前. ### 升级协助( a) 将本项目中的AIDE方法文物与犬科版本相比较,并返回按类别分类的结构化的diff. 第1通电话(无) `category`),返回具有漂移状态的每个类别的轻量级摘要。 以后的电话(与 `category`),将该类的所有已忽略或缺失的文件写入磁盘并返回一个清单. **输入 :** - `framework` (弦,可选): 强制特定框架而不是自动检测。 其中一个: `claude`, (中文(简体) ), `cursor`, (中文(简体) ), `windsurf`, (中文(简体) ), `copilot`。 。 。 . - `path` (弦,可选): 自定义工程根路径 。 服务器工作目录的默认值 . - `category` (弦,可选): 为这个类别写出所有漂移或丢失的文件并返回清单 。 其中一个: `pointer-stub`, (中文(简体) ), `methodology-docs`, (中文(简体) ), `version-metadata`, (中文(简体) ), `commands`, (中文(简体) ), `agents`, (中文(简体) ), `skills`, (中文(简体) ), `mcp`, (中文(简体) ), `ide`, (中文(简体) ), `readme`. Omit 在第一个呼叫中获得一个只包含元数据的摘要. ## 开始 在将服务器添加到您的 MCP 客户端后, 请请求您的代理运行 `aide_init` 将AIDE方法拖入您的项目。 这安装了方法文件,脚手架管道命令, 并且把所有东西都连接起来. 那就试试: “为我的认证模块设置脚手架”——代理商将使用 `aide_discover` 以映射您的项目和 `aide_scaffold` 以正确的命名惯例在正确的位置创建 spec . ## 发展 ```bash npm install npm run build npm test ``` ## 许可证 [麻省理工学院](https://github.com/aidemd-mcp/server/blob/main/LICENSE) ## 常见问题 ### @aidemd-mcp/server 是什么？ 通过工具描述和渐进披露工具来教给任何代理人的 MCP 服务器 ### 如何安装 @aidemd-mcp/server？ 在项目目录运行 npm install @aidemd-mcp/server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 server、aidemd-mcp，可以用 npx server 直接运行。 ### @aidemd-mcp/server 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @aidemd-mcp/server 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @aidemd-mcp/server 可以商用吗？ @aidemd-mcp/server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @aidemd-mcp/server 的下载量有多少？ 根据 npm 官方下载统计，@aidemd-mcp/server 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,070 次，日均约 102 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @aidemd-mcp/server 还在维护吗？ 最新版本 0\.15\.0 发布于 2026/10/28（10 天前）；至今共发布 50 个版本，其中过去 12 个月发布了 50 个；首次发布于 2026/04/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。