@aidemd-mcp/server

MCP-сервер, который привносит разработку, управляемую намерениями (intent-driven development), в любую IDE с поддержкой AI. Управляйте файлами спецификаций .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

Эта команда:

• Объединяет запись MCP-сервера AIDE в .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 (строка, опционально): Подкаталог для углубленного анализа. При указании ответ открывается с цепочкой предков — каскадной линией намерений от корня до цели, где каждый предок показывает свое описание и статус согласования, — за которой следует подробное поддерево с краткими описаниями и предупреждениями. Если опущено, возвращает поверхностную карту всего проекта (только расположения и типы).

aide_read

Читает файл спецификации .aide с полным контекстом, возвращая содержимое файла, его классифицированный тип (intent/research/plan/todo), связанные спецификации в той же директории и ссылки, найденные в содержимом.

Входные данные:

• path (строка, обязательно): Путь к файлу .aide для чтения.

aide_scaffold

Создает новые файлы спецификаций .aide с автоматическим соблюдением соглашений об именовании. Обрабатывает правила переименования: спецификации намерений по умолчанию имеют расширение .aide, но становятся intent.aide, когда в той же папке существует research.aide; создание research.aide автоматически переименовывает любой существующий .aide в intent.aide.

Входные данные:

• directory (строка, обязательно): Директория, в которой будут созданы файлы .aide.

• type (строка, обязательно): Тип создаваемого файла .aide. Один из: intent, research, both, todo, plan.

aide_validate

Запускает проверку работоспособности файлов спецификаций .aide в проекте. Обнаруживает осиротевшие спецификации, отсутствующие спецификации, конфликты имен (.aide и intent.aide в одной папке), битые ссылки, осиротевшие файлы исследований и отсутствие описаний в frontmatter.

Входные данные:

• path (строка, опционально): Подкаталог для проверки. По умолчанию проверяется весь проект, если опущено.

aide_init

Выполняет начальную настройку среды разработки AIDE в проекте с помощью пошагового мастера. При первом вызове (без category) возвращает сводку каждого шага со статусом и обнаруженной средой. При последующих вызовах (с category) записывает все ожидающие файлы для этой категории на диск и возвращает манифест.

Входные данные:

• framework (строка, опционально): Принудительное использование конкретной среды вместо автоопределения. Один из: claude, cursor, windsurf, copilot.

• path (строка, опционально): Пользовательский корневой путь проекта. По умолчанию — рабочая директория сервера.

• category (строка, опционально): Записывает все файлы would-create для этой категории и возвращает манифест. Один из: framework, methodology, commands, agents, skills, mcp, brain, ide. Опустите при первом вызове, чтобы получить сводку только с метаданными.

• brainPath (строка, опционально): Разрешенный путь к хранилищу brain. Обязательно, когда category=brain.

aide_upgrade

Сравнивает артефакты методологии AIDE в этом проекте с каноническими версиями и возвращает структурированный diff, сгруппированный по категориям. При первом вызове (без category) возвращает легкую сводку каждой категории со статусом отклонения. При последующих вызовах (с category) записывает все измененные или отсутствующие файлы для этой категории на диск и возвращает манифест.

Входные данные:

• framework (строка, опционально): Принудительное использование конкретной среды вместо автоопределения. Один из: claude, cursor, windsurf, copilot.

• path (строка, опционально): Пользовательский корневой путь проекта. По умолчанию — рабочая директория сервера.

• category (строка, опционально): Записывает все измененные или отсутствующие файлы для этой категории и возвращает манифест. Один из: pointer-stub, methodology-docs, version-metadata, commands, agents, skills, mcp, ide. Опустите при первом вызове, чтобы получить сводку только с метаданными.

Начало работы

После добавления сервера в ваш MCP-клиент попросите агента запустить aide_init для внедрения методологии AIDE в ваш проект. Это установит документы по методологии, создаст команды конвейера и все настроит.

Затем попробуйте: "Scaffold an intent spec for my authentication module" — агент использует aide_discover для отображения вашего проекта и aide_scaffold для создания спецификации в нужном месте с правильными соглашениями об именовании.

Разработка

npm install
npm run build
npm test

Лицензия

MIT