MCP для IDE

Как разрабатывать пакеты в своём редакторе: локальная EVA отдаёт MCP-сервер с инструментами для создания, проверки и запуска пакетов. Подходит для Cursor и других клиентов MCP.

Сервер /mcp/eva-packages работает только в локальной EVA: в EVA Desktop или при запуске с EVA_MODE=local. В облачной установке его нет.

Подключение

EVA Desktop выбирает порт локального API один раз при первом запуске и записывает его в ~/.eva/desktop.json, поле ports.api. Это число больше 40000. При запуске из исходников с EVA_MODE=local порт берётся из PORT, по умолчанию 3000. В примерах ниже подставьте свой порт.

Cursor, файл .cursor/mcp.json:

{
  "mcpServers": {
    "eva-packages": { "url": "http://127.0.0.1:3000/mcp/eva-packages" }
  }
}

Для клиентов, которые умеют только stdio:

{
  "mcpServers": {
    "eva-packages": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://127.0.0.1:3000/mcp/eva-packages"]
    }
  }
}

Если задана переменная EVA_PACKAGES_MCP_TOKEN, сервер требует токен в заголовке Authorization: Bearer <токен> или x-eva-packages-mcp-token. Без переменной сервер токен не проверяет, поэтому не открывайте порт локальной EVA наружу.

Инструменты

Инструмент	Что делает
eva_pkg_handbook	Справка по манифесту, SDK и правилам. Начните с неё
eva_pkg_list	Список пакетов в локальном хранилище
eva_pkg_create	Создать черновик пакета навыков или фонового сервиса
eva_pkg_get	Манифест и файлы пакета
eva_pkg_store_path	Путь к папке пакета, чтобы править файлы в редакторе
eva_pkg_refresh	Перечитать пакет после правок на диске
eva_pkg_npm	Поставить зависимости
eva_pkg_check	Проверка, как кнопка Проверить в Студии
eva_bg_start, eva_bg_stop, eva_bg_restart	Управлять фоновым сервисом
eva_bg_status	Состояние сервиса
eva_bg_logs	Последние строки лога

Типичный цикл

Публикация версии и раздача пользователям остаются в Студии: Жизненный цикл.