@nimbus-dev/mcp

これは何か

ローカルの Nimbus インデックスとエージェントを、あらゆる MCP（Model Context Protocol）クライアント（エディタ、チャットクライアント、その他の MCP 対応ツール）に公開する小さなランチャーです。それ自体は何も処理しません。マシンにインストール済みの Nimbus CLI バイナリを探し出し、nimbus mcp-server --stdio として exec し、あとは邪魔をせずに stdio をそのまま通過させます。

このパッケージは MIT ライセンスであり、AGPL-3.0 の packages/cli や packages/gateway の Nimbus ソースには依存（または import）しません。インストール済みバイナリの探し方だけを知っており、ゲートウェイ自体の実行方法は知りません。

Nimbus ゲートウェイがインストール済みである必要があります。 このランチャーは Nimbus をインストールしたりバンドルしたりしません。通常の Nimbus インストーラを先に実行し、ゲートウェイは普段どおりの設定のままにしてください（mcp-server --stdio コマンドは既存のローカルインデックスと通信します）。

Related MCP server: mcp-cli-catalog

インストール

まだ npm に公開されていません。 @nimbus-dev/mcp には release-please エントリも publish ワークフローもありません。レジストリへの登録は意図的にリリース作業まで延期されています。以下の npm / npx の手順は公開後に使用するものです。それまではローカルチェックアウトから実行するを使用してください。

グローバルインストールせずに MCP クライアントの設定から直接実行するか（下記参照）、明示的にインストールしてください：

npm install -g @nimbus-dev/mcp

クイックスタート

MCP クライアントのサーバー設定に、たとえば次のように nimbus-mcp をコマンドとして追加します：

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

ローカルチェックアウトから実行する

パッケージが公開されるまでは、Nimbus リポジトリのクローン内にあるランチャーのエントリポイントを MCP クライアントに直接指定してください。絶対パスを使用してください。エディタが起動した 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 — PATH 上で見つかった最初の nimbus（Windows では nimbus.exe）。

3. プラットフォームごとの既知のインストールディレクトリ。インストーラ自身の出力ディレクトリが最初です：Windows では %LOCALAPPDATA%\Programs\Nimbus\bin、macOS と Linux では ~/.local/bin、次に /opt/homebrew/bin と /usr/local/bin（macOS）、または /usr/local/bin と /usr/bin（Linux）。

ステップ 3 は、macOS で GUI から起動されたエディタ（通常、シェルの PATH なしで MCP サーバーを起動します）を支える仕組みです。いずれも解決できない場合、ランチャーは修正方法を示すメッセージとともに終了します。裸の終了コードだけを返すことはありません。

環境変数

• NIMBUS_BIN — 解決されたバイナリパスを上書きします。正確な Nimbus CLI 実行可能ファイルを指定してください。

• NIMBUS_MCP_TIMEOUT_MS — Nimbus CLI の MCP アダプタがエージェントのブリーフを待ってからクリーンなタイムアウトエラーを返すまでの時間。デフォルトは 60 秒です。エディタ自身の MCP トランスポートのタイムアウトがより短い場合は、この値を下げてください。そうすれば、呼び出しがその下で切断される代わりに、ツールがタイムアウトを報告します。これはアダプタ自身の予算であり、ゲートウェイはそのようなタイムアウトを課しません。この値は、このランチャーが環境をそのまま継承して exec する基盤の nimbus mcp-server プロセスによって読み取られます。

関連情報

• docs/architecture.md — Nimbus のサブシステム設計と MCP コネクタ標準。

• メインの Nimbus リポジトリ（packages/gateway、packages/cli）にあるゲートウェイの mcp-server コマンド — このパッケージはそれを起動しますが、含んだりライセンスしたりはしません。

ライセンス

MIT — LICENSE を参照してください。このランチャーが exec する Nimbus ゲートウェイと CLI は、別途 AGPL-3.0 のもとでライセンスされていることに注意してください。