nimbus

@nimbus-dev/mcp

概要

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

このパッケージは MIT ライセンスで、AGPL-3.0 の packages/cli または packages/gateway にある Nimbus ソースには依存せず、そこからインポートもしません。インストール済みバイナリの「場所を見つける」方法だけを把握しており、ゲートウェイ自体の実行方法は把握していません。

Nimbus ゲートウェイがすでにインストールされ、実行中である必要があります。 このランチャーは Nimbus をインストールしたり、同梱したりしません。まず通常の Nimbus インストーラーを実行し、普段どおりにゲートウェイを設定してください（mcp-server --stdio コマンドは既存のローカルインデックスと通信します）。nimbus start でゲートウェイを起動してください。ゲートウェイがなくても MCP サーバーは起動しますが、その場合、ツール呼び出しはゲートウェイの起動を求めるエラーを返します。

範囲

バイナリを見つけ、stdio を継承させて起動し、子プロセスの終了ステータスをクライアントに返すのに必要な間だけプロセスツリーにとどまることが、このパッケージのすべてです。この方針を守ることで、起動するゲートウェイが AGPL-3.0 であっても、このパッケージは MIT ライセンスを維持できます。具体的には、次のことは行いません。

• Nimbus のインストール、同梱、更新、バージョン確認。 通常の Nimbus インストーラーを使用してください。
• MCP ツールの実装。 インデックスとエージェントのツールは、Nimbus モノレポの packages/cli と packages/gateway にある nimbus mcp-server が提供します。ツールが見つからない、または正常に動作しない場合、問題があるのはこのパッケージではなく、そちらです。
• MCP ストリームの解析、フィルタリング、プロキシ、書き換え。 子プロセスは stdio を継承し、通信は両方向とも変更されずに通過します。
• ゲートウェイの設定、認証、インデックス自体の管理。 普段どおりに設定してください。このランチャーは環境を変更せずに引き継ぎ、それ以外は何も行いません。
• 実行時依存関係の追加。 package.json にあるのは devDependencies のみです。これはスタイル上の好みではなく、ライセンスとサプライチェーンの境界です。ここに実行時依存関係を追加するのは、利便性のためではなく、意図的な判断でなければなりません。

インストール

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

npm install -g @nimbus-dev/mcp

クイックスタート

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

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

MCP Registry からインストールするクライアントでは、このサーバーを io.github.nimbus-agent/nimbus として見つけられます。

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

this repository をクローンして、開発時やリリース前に変更を試すためにランチャーを直接実行するには、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. 既知のプラットフォーム別インストールディレクトリ。まずインストーラー自身の出力先を検索し、次に他の Nimbus 配布チャネルが使用するディレクトリを検索します。

   プラットフォーム	検索順
   Windows	%LOCALAPPDATA%\Programs\Nimbus\bin（インストーラーおよび .msi/winget）、次に Scoop の shim — %SCOOP%\shims または %USERPROFILE%\scoop\shims、次に %SCOOP_GLOBAL%\shims または %ProgramData%\scoop\shims
   macOS	~/.local/bin（インストーラーおよび .pkg）、次に /opt/homebrew/bin および /usr/local/bin（Homebrew）
   Linux	~/.local/bin（インストーラー）、次に /usr/local/bin（apt/yum）および /usr/bin、次に /home/linuxbrew/.linuxbrew/bin および ~/.linuxbrew/bin（Homebrew）

ステップ 3 は、通常はシェルの PATH を使わずに MCP サーバーを起動する、macOS の GUI から起動されたエディターで機能します。どの場所でも見つからない場合、ランチャーは修正方法を明記したメッセージを表示して終了します。終了コードだけで終了することはありません。

Nimbus を別の場所にインストールした場合は、ディレクトリがここに追加されるのを待つのではなく、NIMBUS_BIN を設定してください。

環境変数

• NIMBUS_BIN — 解決されたバイナリパスを上書きします。Nimbus CLI 実行ファイルそのものを指定してください。Windows の場合は nimbus.exe 自体を指定します。Node はシェルを介さずに .cmd や .bat のラッパーを起動できないため、指定すると Failed to start the Nimbus MCP server: spawn EINVAL で失敗します。
• NIMBUS_MCP_TIMEOUT_MS — エージェントの概要が返るまで Nimbus CLI の MCP アダプターが待機する時間です。正常なタイムアウトエラーを返すまでの時間で、デフォルトは 60 秒です。エディター自体の MCP トランスポートタイムアウトがこれより短い場合は、呼び出しが途中で切断されるのではなく、ツールがタイムアウトを報告するように、この値を短くしてください。これはアダプター独自のタイムアウト設定であり、ゲートウェイにはこのようなタイムアウトはありません。この値は、ランチャーが環境を変更せずに引き継いで exec する、内部の nimbus mcp-server プロセスによって読み取られます。

関連項目

• docs/architecture.md — Nimbus のサブシステム設計と MCP コネクター標準について説明しています。
• メインの Nimbus リポジトリにある CLI の mcp-server コマンド（packages/cli。ゲートウェイのインデックスと packages/gateway のエージェントを提供します） — このパッケージはそのコマンドを起動しますが、コマンドを含まず、そのライセンスも提供しません。

ライセンス

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