Criei um Servidor MCP que Fornece ao Claude Código Conhecimento Preciso da Sua Máquina

Recentemente, comecei a usar o Claude Code e notei algo que me incomodou. Antes de fazer qualquer trabalho real, o Claude estava desperdiçando muitos tokens apenas tentando adivinhar a configuração do meu sistema — shell errado, versões de pacotes erradas, URLs de CDN erradas. Ele tentou executar comandos bash na minha máquina Windows. Ele escolheu links de CDN desatualizados. Ele assumiu o gerenciador de pacotes errado. Tudo isso antes mesmo de começar a tarefa real.

Essa frustração me deu uma ideia.

O Problema

Toda vez que você inicia uma sessão do Claude Code, o Claude não tem ideia de como é a sua máquina. Ele não sabe se você está no Windows ou Linux. Ele não sabe qual versão do Node você tem. Ele não sabe qual CDN é mais rápida a partir da sua localização. Ele descobre tudo isso por tentativa e erro — e cada palpite custa tokens.

A pior parte é que isso acontece em cada sessão. Os mesmos erros, os mesmos tokens desperdiçados, repetidamente.

A Ideia

E se houvesse um sistema que ajudasse a IA a saber exatamente como sua máquina está configurada, antes de fazer qualquer coisa?

Essa pergunta me levou a construir preflight — um sistema em duas partes:

1. Um script de detecção que escaneia sua máquina e captura o seu ambiente completo
2. Um servidor MCP que o Claude Code pode chamar para ler essa captura instantaneamente

O Que Ele Detecta

Executar o script de detecção fornece ao Claude tudo o que ele precisa:

• SO, shell e política de execução
• Versões do Node, Python, Flutter, Dart, Git, Docker
• SDK do Android, Java, extensões do VS Code
• Programas instalados — bancos de dados, servidores web, CLIs de nuvem, ferramentas de IA
• Qual CDN é realmente a mais rápida a partir da sua localização (medido ao vivo)
• Chaves SSH, variáveis de ambiente, espaço em disco

Tudo isso é escrito em ~/.preflight/env-config.json — um único arquivo que vive na sua máquina e é atualizado sempre que você executa o script.

O Que o Servidor MCP Faz

O servidor MCP expõe três ferramentas que o Claude Code pode chamar:

get_environment — retorna sua captura completa da máquina. O Claude chama isso no início de uma sessão e sabe instantaneamente sua configuração exata. Sem adivinhações, sem tentativas e erros.

get_package_config — busca versões de pacotes ao vivo do npm, PyPI e pub.dev. Assim, o Claude nunca mais usa uma URL de CDN desatualizada ou versão de pacote errada. Ele tem um fallback estático para quando sua internet está lenta e armazena resultados em cache por uma hora.

generate_claude_md — gera automaticamente um arquivo CLAUDE.md para qualquer projeto, derivado diretamente da sua captura de ambiente. Regras de shell, gerenciador de pacotes, preferência de CDN, configuração do Flutter, peculiaridades do Windows — tudo gerado em segundos.

O Custo de Tokens

Todo o ponto do preflight é a eficiência. Portanto, o servidor MCP em si é projetado para custar quase nada — cerca de 400 tokens por chamada. Compare isso com os milhares que o Claude desperdiça adivinhando sua configuração errada.

O Padrão preflight.json

Enquanto construía isso, percebi algo maior. E se todo programa pudesse registrar sua própria configuração com o preflight? Em vez de o preflight procurar arquivos de configuração do Redis ou portas do PostgreSQL, o Redis poderia simplesmente enviar um preflight.json que diz exatamente como está configurado.

{
  "preflight-spec": "1.0",
  "name": "Redis",
  "version": "7.2.0",
  "config": {
    "port": 6379,
    "config_file": "/etc/redis/redis.conf",
    "cli_command": "redis-cli"
  }
}

O Preflight descobre esses arquivos automaticamente escaneando seus diretórios PATH. Se esse padrão for adotado pela comunidade, o Claude saberá como usar qualquer ferramenta na sua máquina sem nenhuma configuração manual — nunca.

Como Eu Construi

Eu construí o preflight usando o próprio Claude Code, de forma autônoma, sob minha supervisão. A ironia não me escapa — usei o Claude Code para construir uma ferramenta que torna o Claude Code melhor.

Todo o sistema foi construído em poucos dias. Scripts de detecção em PowerShell e bash, um servidor MCP em Node.js, três ferramentas, suporte para três registros de pacotes, suporte multiplataforma, código aberto no GitHub, publicado no npm.

Como Usar

Passo 1 — Execute o script de detecção:

Windows:

powershell -ExecutionPolicy Bypass -File detect.ps1

Mac/Linux:

bash detect.sh

Passo 2 — Instale o servidor MCP:

cd mcp-server
npm install

Passo 3 — Conecte-se ao Claude Code:

claude mcp add preflight-mcp -- node "/path/to/preflight/mcp-server/index.js"

Ou instale diretamente do npm:

npx @malikasana/preflight-mcp

É isso. O Claude Code agora tem conhecimento preciso da sua máquina.

Links

• GitHub: https://github.com/malikasana/preflight