Gleam.br Wiki

🛠️ GBR Gleam Tooling Architect (`gbr_mcp_gleam`) | Governança

Especificação técnica e manual do componente gbr_mcp_gleam.

🛠️ GBR Gleam Tooling Architect (gbr_mcp_gleam)

Este projeto implementa um servidor MCP (Model Context Protocol) nativo em Gleam (Target: Erlang) projetado para gerenciar e validar o ciclo de desenvolvimento das aplicações no monorepo de forma resiliente.

Ele atua como substituto direto em Gleam puro do antigo servidor Python GleamErlArchitect.


🎯 Por Que Existe?

  • *Nativo no BEAM*: Elimina a necessidade de um interpretador Python instalado na máquina de desenvolvimento para validação e compilação do código.
  • *Velocidade de Startup*: Utiliza o poder do ecossistema BEAM/OTP e do suporte a escript para boot imediato.
  • *Interface Segura*: O agente especialista gbr_ai_gleam pode compilar, testar e formatar com segurança projetos e pacotes do monorepo.

⚙️ Ferramentas Exportadas

Este servidor MCP expõe as seguintes ferramentas via stdio:

  • 🔍 **gleam_check**: Verifica a integridade sintática e de tipos de um projeto sub-membro (executa gleam check).
  • 🧹 **gleam_clean**: Limpa o cache de compilação local de um subprojeto para sanar conflitos de build (executa gleam clean).
  • 🧪 **gleam_test**: Executa a suíte de testes automatizados do subprojeto (executa gleam test).
  • 🎨 **gleam_format**: Valida e formata automaticamente o estilo dos arquivos .gleam (executa gleam format).

🚀 Como Executar Localmente

Em Desenvolvimento: bash

Navegue até a pasta do projeto cd apps/gbrmcpgleam

Inicie o servidor MCP via stdio gleam run


📦 Distribuição Otimizada com escript (Gleam v1.16+)

Para obter a máxima eficiência e boot em milissegundos (reduzindo o overhead de carregar o compilador a cada inicialização de agente), podemos compilar o servidor MCP como um script nativo standalone do Erlang (escript):

  1. *Compilar e Exportar o escript*: bash gleam export escript

  2. *Localização do Executável*: O executável final standalone do Erlang é gerado em: build/erlang-escript/gbr_mcp_gleam

  3. *Como Executar o escript gerado*: Você pode rodar o executável diretamente usando o interpretador do Erlang no sistema operacional: bash escript ./build/erlang-escript/gbr_mcp_gleam Isso permite que ele seja fiado em servidores de produção ou no agente de desenvolvimento com latência de startup praticamente nula.