Bult.ai MCP Server

@bultcloud/mcp-server

Servidor oficial Model Context Protocol (MCP) para Bult.ai, uma plataforma DevOps e Plataforma-como-Serviço de hospedagem em nuvem para implantar aplicativos, repositórios GitHub, imagens Docker, bancos de dados e serviços com agentes de IA.

Use o Bult MCP com Claude Desktop, Claude Code, Cursor, Codex e outros clientes compatíveis com MCP para implantar aplicativos, gerenciar infraestrutura em nuvem, inspecionar logs e solucionar problemas de implantações por meio da API do Bult.

Demonstração

Recursos

• Implantar repositórios GitHub, imagens Docker, bancos de dados e serviços de aplicativos a partir de agentes de IA compatíveis com MCP.
• Ferramentas de ciclo de vida do projeto: listar, inspecionar, criar, atualizar, excluir, implantar, iniciar, parar e descartar alterações.
• Gerenciamento de serviços para serviços daemon e de banco de dados, incluindo implantações baseadas em imagem Docker e Git.
• Volumes persistentes, mapeamentos de rota/domínio, modelos, logs de serviços e histórico de builds.
• Anotações de ferramentas MCP para operações somente leitura, idempotentes e destrutivas onde houver suporte.
• Funciona via stdio com Claude Desktop, Claude Code, Cursor, Google Antigravity e outros clientes compatíveis com MCP.

Quando usar o Bult MCP

Use o Bult MCP quando quiser que um agente de IA de codificação implante e opere recursos de hospedagem em nuvem para você. Fluxos de trabalho comuns incluem implantar um repositório GitHub do Cursor, implantar o projeto atual do Claude Code, iniciar uma imagem Docker, criar um serviço de banco de dados, adicionar uma rota pública, verificar logs de build e depurar implantações com falha.

Requisitos

• Node.js 18 ou mais recente.
• Token da API Bult.

Instalação

Se você instalar o pacote globalmente, use o binário bult-mcp:

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

Você também pode executá-lo com npx a partir das configurações do cliente MCP:

npx -y @bultcloud/mcp-server

Configuração

O servidor lê suas configurações de variáveis de ambiente.

Variável	Obrigatório	Descrição
BULT_API_URL	Sim	URL base da API do Bult, https://app.bult.ai.
BULT_API_TOKEN	Sim	Token da API usado para autenticação Bearer.

O servidor encerra durante a inicialização se alguma das variáveis estiver ausente.

Configuração do Cliente MCP

Claude Desktop

Adicione o 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

Código 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

Ferramentas Disponíveis

Projetos

Ferramenta	Descrição
list-projects	Listar todos os projetos no espaço de trabalho.
get-project	Obter uma visão geral do projeto com serviços, volumes e rotas.
create-project	Criar um novo projeto.
update-project	Atualizar o nome de um projeto.
delete-project	Excluir um projeto e todos os seus recursos.
deploy-project	Implantar alterações do projeto e criar um snapshot de versão.
control-project	Iniciar, parar ou descartar alterações do projeto.

Serviços

Ferramenta	Descrição
list-services	Listar todos os serviços em um projeto.
get-service	Obter detalhes e configuração do serviço.
create-service	Criar um serviço daemon ou banco de dados.
update-service	Atualizar a configuração do serviço.
delete-service	Excluir um serviço.
control-service	Iniciar, parar ou reconstruir um serviço.

Volumes

Ferramenta	Descrição
create-volume	Criar um volume de armazenamento persistente.
update-volume	Atualizar o nome ou tamanho de um volume.
delete-volume	Excluir um volume.
wipe-volume	Apagar irreversivelmente todos os dados de um volume.

Rotas

Ferramenta	Descrição
create-route	Criar um mapeamento de domínio ou caminho para um serviço.
update-route	Atualizar a configuração da rota.
delete-route	Excluir uma rota.

Modelos

Ferramenta	Descrição
list-templates	Listar modelos de projeto disponíveis.
apply-template	Aplicar um modelo a um projeto.

Logs e Builds

Ferramenta	Descrição
get-service-logs	Ler logs de serviço com paginação baseada em cursor.
list-builds	Listar histórico de builds de um serviço.

Exemplos de Prompts

• Implantar este repositório GitHub no Bult e me dar a URL pública.
• Implantar o projeto atual no Bult.
• Verificar por que minha implantação falhou.
• Mostrar os logs mais recentes do meu aplicativo.
• Definir DATABASE_URL e reiniciar o serviço.
• Implantar esta imagem Docker no Bult.
• Listar meus projetos e serviços do Bult.

Desenvolvimento

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

Estrutura do projeto:

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

Segurança

BULT_API_TOKEN concede acesso aos seus recursos do Bult. Mantenha-o fora do controle de versão, histórico do shell, relatórios de problemas e capturas de tela. Prefira tokens escopados ou rotacionáveis quando disponíveis.

Algumas ferramentas podem criar, excluir, implantar, parar ou apagar recursos. Revise as chamadas de ferramentas do seu cliente MCP antes de aprovar ações destrutivas.

Política de Privacidade

Este servidor MCP conecta seu cliente MCP ao Bult.ai usando o token da API que você fornece. As solicitações são enviadas ao Bult.ai para executar ações como listar projetos, implantar serviços, gerenciar rotas e volumes e ler logs.

O servidor não armazena seu token de API. Os tokens são passados pela configuração do seu cliente MCP ou pelas configurações de extensão. Para as práticas de tratamento de dados do Bult.ai, consulte a Política de Privacidade do Bult.ai.

Contribuição

Issues e pull requests são bem-vindos em github.com/bultcloud/mcp-server.

Antes de abrir um pull request, execute:

npm run lint
npm run build

Licença

Este projeto é licenciado sob a Licença MIT.