@ aidemd- mcp/ 服务器
MCP服务器,将意图驱动的开发带给任何AI动力的IDE.
管理 .aide 生活在代码旁边的 spec 文件——域名上下文
建筑师计划从, 执行者建设, 和QA验证反对.
学习更多 帮助.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 代码)
从您的工程根运行安装器 :
npx -y @aidemd-mcp/[email protected] 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 <integration> 选择捆绑的模板(仅限今天) obsidian,默认值).
运行后,打开 Claude 代码并运行 /aide。在第一次运行时,它向 /aide:brain config,填补大脑位置 .aide/config/brain.aide将大脑MCP输入通过同步, 并播种大脑。 还有什么 init 无法完成 .
将大脑同步到Mcp.json
编辑后运行此功能 .aide/config/brain.aide 例如,当你更新大脑路径参数时 mcpServerConfig.args 或重命名大脑在 name 字段 :
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配置文件中.
克劳德代码
安装一次, 然后注册 :
npm i -g @aidemd-mcp/server
claude mcp add aide -- aidemd-mcp
或增加你的项目 .mcp.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数字 :
{
"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数字 :
{
"mcpServers": {
"aide": {
"command": "aidemd-mcp"
}
}
}
VS 代码/ 副驾驶
添加为 .vscode/mcp.json数字 :
之后 npm i -g @aidemd-mcp/server数字 :
{
"servers": {
"aide": {
"command": "aidemd-mcp"
}
}
}
[注] VS 代码/ 副驾驶使用
"servers"作为根键,不是"mcpServers"。使用错误的根键会使服务器静默地无法加载.
风起浪起
添加为 ~/.windsurf/mcp.json数字 :
之后 npm i -g @aidemd-mcp/server数字 :
{
"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@<version> 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 .
发展
npm install
npm run build
npm test