@nimbus-dev/mcp

이게 무엇인가

로컬 Nimbus 인덱스와 에이전트를 모든 MCP(Model Context Protocol) 클라이언트 — 에디터, 채팅 클라이언트, 기타 MCP를 사용하는 도구 —에 노출하는 작은 런처입니다. 자체적으로는 아무 작업도 하지 않습니다. 머신에 이미 설치된 Nimbus CLI 바이너리를 찾아 nimbus mcp-server --stdio로 실행한 다음, 비켜서서 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, 그 다음 macOS의 /opt/homebrew/bin과 /usr/local/bin, 또는 Linux의 /usr/local/bin과 /usr/bin.

3단계가 macOS에서 GUI로 실행되는 에디터를 지원합니다. 이러한 에디터는 일반적으로 셸의 PATH 없이 MCP 서버를 생성합니다. 이 중 어느 것으로도 찾지 못하면 런처는 해결 방법을 알려주는 메시지와 함께 종료됩니다 — 결코 종료 코드만으로 종료하지 않습니다.

환경 변수

• NIMBUS_BIN — 확인된 바이너리 경로를 재정의합니다. 정확한 Nimbus CLI 실행 파일을 가리키도록 설정하세요.

• NIMBUS_MCP_TIMEOUT_MS — Nimbus CLI의 MCP 어댑터가 에이전트 브리프를 기다렸다가 깔끔한 타임아웃 오류를 반환하기까지의 시간입니다. 기본값은 60초입니다. 에디터 자체의 MCP 전송 타임아웃이 더 짧다면 이 값을 낮추세요. 그러면 호출이 그 아래에서 끊기는 대신 도구가 타임아웃을 보고합니다. 이는 어댑터 자체의 예산입니다 — 게이트웨이는 그러한 타임아웃을 부과하지 않습니다. 이 값은 이 런처가 환경을 변경 없이 그대로 상속하여 실행하는 기본 nimbus mcp-server 프로세스가 읽습니다.

함께 보기

• docs/architecture.md — Nimbus 하위 시스템 설계 및 MCP 커넥터 표준.

• 메인 Nimbus 저장소의 게이트웨이 mcp-server 명령(packages/gateway, packages/cli) — 이 패키지는 이를 실행하지만, 포함하거나 라이선스를 부여하지는 않습니다.

라이선스

MIT — LICENSE를 참조하세요. 이 런처가 실행하는 Nimbus 게이트웨이와 CLI는 별도로 AGPL-3.0에 따라 라이선스가 부여됩니다.