Bult.ai MCP Server

@bultcloud/mcp-server

Servidor oficial del Protocolo de Contexto de Modelos (MCP) para Bult.ai, una plataforma DevOps y servicio de hosting en la nube (PaaS) para desplegar aplicaciones, repositorios de GitHub, imágenes Docker, bases de datos y servicios con agentes de IA.

Usa Bult MCP con Claude Desktop, Claude Code, Cursor, Codex y otros clientes compatibles con MCP para desplegar aplicaciones, gestionar infraestructura en la nube, inspeccionar registros y solucionar problemas de despliegues a través de la API de Bult.

Demo

Características

• Despliega repositorios de GitHub, imágenes Docker, bases de datos y servicios de aplicaciones desde agentes de IA compatibles con MCP.
• Herramientas de ciclo de vida de proyectos: listar, inspeccionar, crear, actualizar, eliminar, desplegar, iniciar, detener y descartar cambios.
• Gestión de servicios para servicios daemon y de bases de datos, incluyendo despliegues basados en imágenes Docker y Git.
• Volúmenes persistentes, asignaciones de rutas/dominios, plantillas, registros de servicios e historial de compilaciones.
• Anotaciones de herramientas MCP para operaciones de solo lectura, idempotentes y destructivas donde sean compatibles.
• Funciona a través de stdio con Claude Desktop, Claude Code, Cursor, Google Antigravity y otros clientes compatibles con MCP.

Cuándo usar Bult MCP

Usa Bult MCP cuando quieras que un agente de IA de codificación despliegue y opere recursos de hosting en la nube por ti. Los flujos de trabajo comunes incluyen desplegar un repositorio de GitHub desde Cursor, desplegar el proyecto actual desde Claude Code, lanzar una imagen Docker, crear un servicio de base de datos, añadir una ruta pública, comprobar registros de compilación y depurar despliegues fallidos.

Requisitos

• Node.js 18 o más reciente.
• Token de API de Bult.

Instalación

Si instalas el paquete globalmente, usa el binario bult-mcp:

npm install -g @bultcloud/mcp-server
bult-mcp

También puedes ejecutarlo con npx desde las configuraciones del cliente MCP:

npx -y @bultcloud/mcp-server

Configuración

El servidor lee su configuración de las variables de entorno.

Variable	Requerida	Descripción
BULT_API_URL	Sí	URL base de la API de Bult, https://app.bult.ai.
BULT_API_TOKEN	Sí	Token de API utilizado para la autenticación Bearer.

El servidor se cierra durante el inicio si falta alguna de las variables.

Configuración del Cliente MCP

Claude Desktop

Añade el servidor a claude_desktop_config.json.

Usando npx:

{
  "mcpServers": {
    "bult": {
      "command": "npx",
      "args": ["-y", "@bultcloud/mcp-server"],
      "env": {
        "BULT_API_URL": "https://app.bult.ai",
        "BULT_API_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

Usando npx:

claude mcp add bult \
  -e BULT_API_URL=https://app.bult.ai \
  -e BULT_API_TOKEN=your-token \
  -- npx -y @bultcloud/mcp-server

Codex CLI

Usando npx:

codex mcp add \
  --env BULT_API_URL=https://app.bult.ai \
  --env BULT_API_TOKEN=your-token \
  bult \
  -- npx -y @bultcloud/mcp-server

Herramientas Disponibles

Proyectos

Herramienta	Descripción
list-projects	Lista todos los proyectos en el espacio de trabajo.
get-project	Obtén una visión general del proyecto con servicios, volúmenes y rutas.
create-project	Crea un nuevo proyecto.
update-project	Actualiza el nombre de un proyecto.
delete-project	Elimina un proyecto y todos sus recursos.
deploy-project	Despliega los cambios del proyecto y crea una instantánea de versión.
control-project	Inicia, detiene o descarta cambios del proyecto.

Servicios

Herramienta	Descripción
list-services	Lista todos los servicios en un proyecto.
get-service	Obtén detalles y configuración del servicio.
create-service	Crea un servicio daemon o de base de datos.
update-service	Actualiza la configuración del servicio.
delete-service	Elimina un servicio.
control-service	Inicia, detiene o reconstruye un servicio.

Volúmenes

Herramienta	Descripción
create-volume	Crea un volumen de almacenamiento persistente.
update-volume	Actualiza el nombre o tamaño de un volumen.
delete-volume	Elimina un volumen.
wipe-volume	Borra irreversiblemente todos los datos de un volumen.

Rutas

Herramienta	Descripción
create-route	Crea una asignación de dominio o ruta para un servicio.
update-route	Actualiza la configuración de la ruta.
delete-route	Elimina una ruta.

Plantillas

Herramienta	Descripción
list-templates	Lista las plantillas de proyecto disponibles.
apply-template	Aplica una plantilla a un proyecto.

Registros y Compilaciones

Herramienta	Descripción
get-service-logs	Lee los registros del servicio con paginación basada en cursor.
list-builds	Lista el historial de compilaciones de un servicio.

Ejemplos de Prompts

• Despliega este repositorio de GitHub en Bult y dame la URL pública.
• Despliega el proyecto actual en Bult.
• Comprueba por qué falló mi despliegue.
• Muestra los últimos registros de mi aplicación.
• Configura DATABASE_URL y reinicia el servicio.
• Despliega esta imagen Docker en Bult.
• Lista mis proyectos y servicios de Bult.

Desarrollo

npm run dev      # run with tsx, no build step
npm run build    # compile TypeScript to dist/
npm run lint     # type-check without emitting files

Estructura del proyecto:

src/index.ts          MCP server entrypoint
src/client.ts         Bult API client
src/tools/*.ts        MCP tool registrations by resource type

Seguridad

BULT_API_TOKEN otorga acceso a tus recursos de Bult. Mantenlo fuera del control de versiones, historial de shell, informes de problemas y capturas de pantalla. Prefiere tokens con alcance o rotativos cuando estén disponibles.

Algunas herramientas pueden crear, eliminar, desplegar, detener o borrar recursos. Revisa las llamadas de herramientas de tu cliente MCP antes de aprobar acciones destructivas.

Política de Privacidad

Este servidor MCP conecta tu cliente MCP a Bult.ai usando el token de API que proporcionas. Las solicitudes se envían a Bult.ai para realizar acciones como listar proyectos, desplegar servicios, gestionar rutas y volúmenes, y leer registros.

El servidor no almacena tu token de API. Los tokens se pasan a través de la configuración de tu cliente MCP o ajustes de extensión. Para las prácticas de manejo de datos de Bult.ai, consulta la Política de Privacidad de Bult.ai.

Contribuciones

Las incidencias y solicitudes de extracción son bienvenidas en github.com/bultcloud/mcp-server.

Antes de abrir una solicitud de extracción, ejecuta:

npm run lint
npm run build

Licencia

Este proyecto está licenciado bajo la Licencia MIT.