@nimbus-dev/mcp

Что это

Крошечный загрузчик, который предоставляет ваш локальный индекс и агентов Nimbus любому клиенту MCP (Model Context Protocol) — редакторам, чат-клиентам или другим инструментам, говорящим на MCP. Сам он не выполняет никакой работы: он находит уже установленный в вашей системе бинарный файл Nimbus CLI и запускает его как nimbus mcp-server --stdio, а затем уходит с дороги, позволяя stdio проходить напрямую.

Этот пакет распространяется под лицензией MIT и не зависит от (и не импортирует) исходных кодов Nimbus packages/cli или packages/gateway под лицензией AGPL-3.0 — он умеет только находить установленный бинарный файл, но не запускать сам шлюз.

Требуется предварительно установленный шлюз Nimbus. Этот загрузчик не устанавливает и не включает в себя Nimbus; сначала запустите обычный установщик Nimbus и настройте шлюз так, как вы обычно это делаете (команда mcp-server --stdio обращается к вашему существующему локальному индексу).

Related MCP server: mcp-cli-catalog

Установка

В npm пока не опубликовано. У @nimbus-dev/mcp нет записи release-please и рабочего процесса публикации — отправка в реестр намеренно отложена до релизной активности. Приведённые ниже инструкции npm / npx пригодятся вам после публикации; до тех пор используйте Запуск из локальной копии.

Запустите его напрямую, без глобальной установки, из конфигурации вашего MCP-клиента (см. ниже) или установите явно:

npm install -g @nimbus-dev/mcp

Быстрый старт

Добавьте nimbus-mcp как команду в конфигурацию сервера вашего MCP-клиента, например:

{
  "mcpServers": {
    "nimbus": {
      "command": "npx",
      "args": ["-y", "@nimbus-dev/mcp"]
    }
  }
}

Запуск из локальной копии

Пока пакет не опубликован, укажите вашему MCP-клиенту непосредственно точку входа загрузчика в клоне репозитория Nimbus. Используйте абсолютные пути — запущенный редактором MCP-сервер не наследует рабочую директорию вашей оболочки:

{
  "mcpServers": {
    "nimbus": {
      "command": "bun",
      "args": ["/absolute/path/to/nimbus-mcp/src/index.ts"]
    }
  }
}

Если у вас уже установлен Nimbus CLI, вы можете вообще пропустить загрузчик и заставить клиент запускать nimbus mcp-server --stdio напрямую — загрузчик существует только для того, чтобы найти этот бинарный файл за вас.

Как находится бинарный файл

Загрузчик ищет бинарный файл Nimbus в следующем порядке:

1. NIMBUS_BIN — явный полный путь к бинарному файлу, если он задан. NIMBUS_BIN, указывающий на несуществующий файл, вызывает сообщение об ошибке и никогда не игнорируется молча.

2. PATH — первый найденный nimbus (или nimbus.exe в Windows) в вашем PATH.

3. Известные каталоги установки для конкретной платформы, в первую очередь собственный выходной каталог установщика: %LOCALAPPDATA%\Programs\Nimbus\bin в Windows, ~/.local/bin в macOS и Linux, затем /opt/homebrew/bin и /usr/local/bin (macOS) или /usr/local/bin и /usr/bin (Linux).

Шаг 3 — это то, что поддерживает запущенный из графического интерфейса редактор в macOS, который обычно порождает MCP-серверы без PATH вашей оболочки. Если ни один из этих вариантов не сработает, загрузчик завершится с сообщением, указывающим на исправление, — никогда не с голым кодом возврата.

Переменные окружения

• NIMBUS_BIN — переопределяет разрешённый путь к бинарному файлу. Укажите точный исполняемый файл Nimbus CLI.

• NIMBUS_MCP_TIMEOUT_MS — как долго MCP-адаптер Nimbus CLI ждёт бриф агента, прежде чем вернуть понятную ошибку тайм-аута; по умолчанию 60 с. Уменьшите его, если собственный тайм-аут транспорта MCP вашего редактора короче, чтобы инструмент сообщал о тайм-ауте, а не позволял разорвать вызов под ним. Это собственный бюджет адаптера — шлюз такого тайм-аута не накладывает. Его читает базовый процесс nimbus mcp-server, который этот загрузчик запускает с унаследованным без изменений вашим окружением.

См. также

• docs/architecture.md — проектирование подсистем Nimbus и стандарт MCP-коннектора.

• Команда mcp-server шлюза в основном репозитории Nimbus (packages/gateway, packages/cli) — этот пакет запускает его, но не содержит и не лицензирует.

Лицензия

MIT — см. LICENSE. Обратите внимание, что шлюз Nimbus и CLI, которые запускает этот загрузчик, лицензированы отдельно по AGPL-3.0.