@nimbus-dev/mcp

Was das ist

Ein winziger Launcher, der Ihren lokalen Nimbus-Index und Ihre Agents für beliebige MCP (Model Context Protocol)-Clients verfügbar macht – Editoren, Chat-Clients oder andere MCP-fähige Tools. Er selbst leistet keine Arbeit: Er findet das bereits auf Ihrem Rechner installierte Nimbus-CLI-Binary und führt es als nimbus mcp-server --stdio aus, tritt dann zur Seite und lässt stdio direkt durchfließen.

Dieses Paket ist MIT-lizenziert und hängt nicht von der AGPL-3.0-Nimbus-Quelle packages/cli oder packages/gateway ab (und importiert nicht daraus) – es weiß nur, wie es das installierte Binary findet, nicht wie es das Gateway selbst ausführt.

Setzt voraus, dass das Nimbus-Gateway bereits installiert ist. Dieser Launcher installiert oder bündelt Nimbus nicht; führen Sie zuerst den regulären Nimbus-Installer aus und lassen Sie das Gateway so konfiguriert, wie Sie es normalerweise verwenden (der Befehl mcp-server --stdio kommuniziert mit Ihrem vorhandenen lokalen Index).

Related MCP server: mcp-cli-catalog

Installation

Noch nicht auf npm veröffentlicht. @nimbus-dev/mcp hat keinen release-please-Eintrag und keinen Publish-Workflow – die Einreichung im Registry wird bewusst auf eine Release-Aktivität verschoben. Die npm- / npx-Anweisungen unten sind das, was Sie sobald es veröffentlicht ist verwenden werden; bis dahin nutzen Sie Ausführen aus einem lokalen Checkout.

Führen Sie es direkt, ohne globale Installation, aus der Konfiguration Ihres MCP-Clients aus (siehe unten) oder installieren Sie es explizit:

npm install -g @nimbus-dev/mcp

Schnellstart

Fügen Sie nimbus-mcp als Befehl in der Serverkonfiguration Ihres MCP-Clients hinzu, zum Beispiel:

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

Ausführen aus einem lokalen Checkout

Bis das Paket veröffentlicht ist, richten Sie Ihren MCP-Client direkt auf den Einstiegspunkt des Launchers in einem Klon des Nimbus-Repositorys aus. Verwenden Sie absolute Pfade – ein vom Editor gestarteter MCP-Server erbt nicht das Arbeitsverzeichnis Ihrer Shell:

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

Wenn Sie das Nimbus-CLI bereits installiert haben, können Sie den Launcher ganz überspringen und Ihren Client nimbus mcp-server --stdio direkt ausführen lassen – der Launcher existiert nur, um dieses Binary für Sie zu finden.

Wie das Binary gefunden wird

Der Launcher sucht das Nimbus-Binary in dieser Reihenfolge:

1. NIMBUS_BIN – ein expliziter vollständiger Pfad zum Binary, falls gesetzt. Ein NIMBUS_BIN, das auf eine nicht vorhandene Datei zeigt, wird als Fehler gemeldet und niemals stillschweigend ignoriert.

2. PATH – das erste nimbus (oder nimbus.exe unter Windows), das in Ihrem PATH gefunden wird.

3. Bekannte plattformspezifische Installationsverzeichnisse, zuerst das eigene Ausgabeverzeichnis des Installers: %LOCALAPPDATA%\Programs\Nimbus\bin unter Windows, ~/.local/bin unter macOS und Linux, dann /opt/homebrew/bin und /usr/local/bin (macOS) oder /usr/local/bin und /usr/bin (Linux).

Schritt 3 ist das, was einen per GUI gestarteten Editor unter macOS trägt, der MCP-Server typischerweise ohne das PATH Ihrer Shell startet. Wenn keiner dieser Schritte erfolgreich ist, beendet sich der Launcher mit einer Meldung, die die Lösung nennt – niemals mit einem bloßen Exit-Code.

Umgebungsvariablen

• NIMBUS_BIN – überschreibt den aufgelösten Binary-Pfad. Richten Sie ihn auf die genaue ausführbare Datei des Nimbus-CLI.

• NIMBUS_MCP_TIMEOUT_MS – wie lange der MCP-Adapter des Nimbus-CLI auf ein Agenten-Briefing wartet, bevor er einen sauberen Timeout-Fehler zurückgibt; standardmäßig 60 s. Senken Sie ihn, wenn das eigene MCP-Transport-Timeout Ihres Editors kürzer ist, damit das Tool einen Timeout meldet, statt dass der Aufruf darunter abgeschnitten wird. Dies ist das eigene Budget des Adapters – das Gateway auferlegt kein solches Timeout. Dieser Wert wird vom zugrunde liegenden nimbus mcp-server-Prozess gelesen, den dieser Launcher mit Ihrer unverändert vererbten Umgebung ausführt.

Siehe auch

• docs/architecture.md – Nimbus-Subsystemdesign und der MCP-Connector-Standard.

• Der mcp-server-Befehl des Gateways im Haupt-Nimbus-Repository (packages/gateway, packages/cli) – dieses Paket startet ihn, enthält oder lizenziert ihn jedoch nicht.

Lizenz

MIT – siehe LICENSE. Beachten Sie, dass das Nimbus-Gateway und das CLI, die dieser Launcher ausführt, separat unter AGPL-3.0 lizenziert sind.