@nimbus-dev/mcp

Qué es esto

Un pequeño lanzador que expone tu índice y agentes locales de Nimbus a cualquier cliente MCP (Model Context Protocol) — editores, clientes de chat u otras herramientas que hablen MCP. No hace ningún trabajo por sí mismo: localiza el binario de la CLI de Nimbus ya instalado en tu máquina y lo ejecuta como nimbus mcp-server --stdio, luego se aparta y deja que stdio pase directamente.

Este paquete tiene licencia MIT y no depende de (ni importa desde) el código fuente de Nimbus packages/cli o packages/gateway, que está bajo AGPL-3.0 — solo sabe encontrar el binario instalado, nunca cómo ejecutar la pasarela en sí.

Requiere que la pasarela de Nimbus ya esté instalada. Este lanzador no instala ni incluye Nimbus; ejecuta primero el instalador normal de Nimbus y mantén la pasarela configurada como la usas habitualmente (el comando mcp-server --stdio se comunica con tu índice local existente).

Related MCP server: mcp-cli-catalog

Instalación

Aún no publicado en npm. @nimbus-dev/mcp no tiene entrada de release-please ni flujo de publicación — el envío al registro se difiere deliberadamente a una actividad de lanzamiento. Las instrucciones de npm / npx a continuación son las que usarás una vez que se publique; hasta entonces, usa Ejecución desde un clon local.

Ejecútalo directamente, sin instalación global, desde la configuración de tu cliente MCP (ver más abajo), o instálalo explícitamente:

npm install -g @nimbus-dev/mcp

Inicio rápido

Añade nimbus-mcp como comando en la configuración de servidor de tu cliente MCP, por ejemplo:

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

Ejecución desde un clon local

Hasta que el paquete se publique, apunta tu cliente MCP directamente al punto de entrada del lanzador en un clon del repositorio de Nimbus. Usa rutas absolutas — un servidor MCP lanzado por el editor no hereda el directorio de trabajo de tu shell:

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

Si ya tienes instalada la CLI de Nimbus, puedes omitir el lanzador por completo y hacer que tu cliente ejecute nimbus mcp-server --stdio directamente — el lanzador existe solo para encontrar ese binario por ti.

Cómo se encuentra el binario

El lanzador busca el binario de Nimbus en este orden:

1. NIMBUS_BIN — una ruta completa explícita al binario, si está definida. Un NIMBUS_BIN que apunte a un archivo inexistente se notifica como error, nunca se ignora silenciosamente.

2. PATH — el primer nimbus (o nimbus.exe en Windows) que se encuentre en tu PATH.

3. Directorios de instalación conocidos por plataforma, empezando por el directorio de salida del propio instalador: %LOCALAPPDATA%\Programs\Nimbus\bin en Windows, ~/.local/bin en macOS y Linux, luego /opt/homebrew/bin y /usr/local/bin (macOS) o /usr/local/bin y /usr/bin (Linux).

El paso 3 es el que se encarga de un editor lanzado desde la GUI en macOS, que normalmente inicia servidores MCP sin el PATH de tu shell. Si ninguna de esas opciones resuelve, el lanzador sale con un mensaje que indica la solución — nunca con un código de salida a secas.

Variables de entorno

• NIMBUS_BIN — sobrescribe la ruta resuelta del binario. Apúntalo al ejecutable exacto de la CLI de Nimbus.

• NIMBUS_MCP_TIMEOUT_MS — cuánto tiempo espera el adaptador MCP de la CLI de Nimbus un brief de agente antes de devolver un error de tiempo de espera limpio; el valor predeterminado es 60 s. Redúcelo cuando el tiempo de espera del transporte MCP de tu editor sea más corto, para que la herramienta notifique un tiempo de espera en lugar de que la llamada se corte por debajo. Este es el presupuesto propio del adaptador — la pasarela no impone ese tiempo de espera. Lo lee el proceso subyacente nimbus mcp-server, que este lanzador ejecuta con tu entorno heredado sin cambios.

Ver también

• docs/architecture.md — diseño de los subsistemas de Nimbus y el estándar del conector MCP.

• El comando mcp-server de la pasarela, en el repositorio principal de Nimbus (packages/gateway, packages/cli) — este paquete lo lanza, pero no lo contiene ni lo licencia.

Licencia

MIT — consulta LICENSE. Ten en cuenta que la pasarela y la CLI de Nimbus que este lanzador ejecuta tienen licencia independiente bajo AGPL-3.0.