@aidemd-mcp/server

一个将意图驱动开发（intent-driven development）引入任何 AI 驱动 IDE 的 MCP 服务器。 管理与代码共存的 .aide 规范文件 —— 这是架构师进行规划、实现者进行构建以及 QA 进行验证的领域上下文。

功能特性

• 全项目规范发现：通过渐进式披露树，在代码库的每一层级展示意图、研究和 QA 规范。

• 一键项目引导：通过 aide_init 实现 —— 在一个引导式流程中将方法论文档、流水线命令和此 MCP 服务器集成到您的项目中。

• 自动命名规范强制执行：aide_scaffold 处理 .aide / intent.aide 重命名规则，确保您永远不会创建冲突的规范。

• 健康检查验证：通过 aide_validate 实现 —— 在导致偏差之前检测孤立规范、缺失描述、损坏链接和命名冲突。

• 升级偏差检测：通过 aide_upgrade 实现 —— 将您项目的 AIDE 方法论工件与规范版本进行比较，并按类别写入更新。

安装

快速开始 (Claude Code)

最快的方法是使用一条 npx 命令自动完成所有配置：

npx @aidemd-mcp/server@latest init

此命令执行以下操作：

• 将 AIDE MCP 服务器条目合并到 .mcp.json 中（如果文件不存在则创建，如果条目已存在则跳过）

• 将 /aide:init 斜杠命令写入 .claude/commands/aide/init.md（如果存在则跳过）

• 将 aide-tree 启动器写入 .aide/bin/aide-tree.mjs（如果存在则跳过）

所有操作都是幂等的 —— 可以随时安全地重新运行。

运行后，打开 Claude Code 并运行 /aide:init 以完成设置。

手动配置

如果您使用的客户端不是 Claude Code，或者更喜欢手动配置，请将服务器条目添加到客户端的 MCP 配置文件中。

Claude Code

claude mcp add aide npx -- -y @aidemd-mcp/server@latest

或者添加到您项目的 .mcp.json 中：

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

Claude Desktop

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

在任何配置更改后，Claude Desktop 需要完全退出并重新打开。

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

VS Code / Copilot

添加到 .vscode/mcp.json：

{
  "servers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

Windsurf

添加到 ~/.windsurf/mcp.json：

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

工具

aide_discover

扫描项目中的 .aide 规范文件，并返回一个渐进式披露树图，显示每个规范的类型、位置和摘要。

输入：

• path (string, 可选): 要深入查看的子目录。提供时，响应将以祖先链开头 —— 从根到目标的级联意图谱系，每个祖先显示其描述和对齐状态 —— 随后是带有摘要和警告的详细子树。省略时，返回一个浅层的全项目地图（仅包含位置和类型）。

aide_read

读取带有完整上下文的 .aide 规范文件，返回文件内容、其分类类型（intent/research/plan/todo）、同一目录下的相关规范以及内容中发现的链接。

输入：

• path (string, 必填): 要读取的 .aide 文件路径。

aide_scaffold

创建带有自动命名规范强制执行的新 .aide 规范文件。处理重命名规则：意图规范默认为 .aide，但当同一文件夹中存在 research.aide 时变为 intent.aide；创建 research.aide 会自动将任何现有的 .aide 重命名为 intent.aide。

输入：

• directory (string, 必填): 将创建 .aide 文件的目录。

• type (string, 必填): 要创建的 .aide 文件类型。可选值：intent, research, both, todo, plan。

aide_validate

对项目中的 .aide 规范文件进行健康检查。检测孤立规范、缺失规范、命名冲突（同一文件夹中同时存在 .aide 和 intent.aide）、损坏的链接、孤立的研究文件以及缺失的前置描述。

输入：

• path (string, 可选): 要验证的子目录。省略时默认为整个项目。

aide_init

使用引导式的一对一向导将 AIDE 开发环境引导至项目中。在第一次调用时（无 category），返回每个步骤的状态和检测到的框架摘要。在后续调用时（带有 category），将该类别的所有待处理文件写入磁盘并返回清单。

输入：

• framework (string, 可选): 强制指定特定框架而不是自动检测。可选值：claude, cursor, windsurf, copilot。

• path (string, 可选): 自定义项目根路径。默认为服务器工作目录。

• category (string, 可选): 写入此类别所有 would-create 文件并返回清单。可选值：framework, methodology, commands, agents, skills, mcp, brain, ide。在第一次调用时省略以获取仅包含元数据的摘要。

• brainPath (string, 可选): 已解析的 brain vault 路径。当 category=brain 时必填。

aide_upgrade

将此项目中的 AIDE 方法论工件与规范版本进行比较，并返回按类别分组的结构化差异。在第一次调用时（无 category），返回每个类别的轻量级摘要及偏差状态。在后续调用时（带有 category），将该类别的所有差异或缺失文件写入磁盘并返回清单。

输入：

• framework (string, 可选): 强制指定特定框架而不是自动检测。可选值：claude, cursor, windsurf, copilot。

• path (string, 可选): 自定义项目根路径。默认为服务器工作目录。

• category (string, 可选): 写入此类别所有有偏差或缺失的文件并返回清单。可选值：pointer-stub, methodology-docs, version-metadata, commands, agents, skills, mcp, ide。在第一次调用时省略以获取仅包含元数据的摘要。

入门

将服务器添加到 MCP 客户端后，要求您的代理运行 aide_init 以将 AIDE 方法论引导至您的项目中。这将安装方法论文档、脚手架流水线命令并连接所有内容。

然后尝试：“为我的身份验证模块构建一个意图规范” —— 代理将使用 aide_discover 映射您的项目，并使用 aide_scaffold 在正确的位置以正确的命名规范创建规范。

开发

npm install
npm run build
npm test

许可证

MIT