Chiplab

Compile, execute e teste firmware em instâncias virtuais de chips reais (STM32, Nordic, etc.) via MCP, sem necessidade de hardware.

Documentação

Chiplab

Simule e valide firmware em instâncias virtuais de chips reais, direto do seu agente de IA de codificação — sem hardware.

License: MIT Discord

Chiplab é um serviço MCP hospedado. Seu agente de IA de codificação se conecta a ele, envia o firmware compilado, executa-o em uma instância virtual de um microcontrolador real e lê a saída UART. Você não controla a cadeia de ferramentas — seu agente faz isso.

Estamos construindo a próxima forma de desenvolver chips, de forma aberta e inicial. Hoje ele executa Hello world! em placas STM32 e Nordic; muito mais está por vir — veja veecle.ai. Experimente, teste e conte-nos o que gostaria de ver.

Quickstart

  1. Crie uma conta gratuita em veecle.ai (sem cartão de crédito).

  2. Conecte seu agente ao servidor MCP do Chiplab.

  3. git clone https://github.com/veecle/chiplab && cd chiplab, então diga ao seu agente:

    "Configure o Chiplab e execute o exemplo stm32f4-discovery nele."

Seu agente lê AGENTS.md, instala o que precisa, compila o firmware, envia, executa na placa virtual e reporta Hello world! de volta da UART do chip. Esse é o ciclo completo.

Conecte seu agente

Chiplab é um servidor MCP HTTP em https://chiplab.veecle.ai/mcp. A maioria dos clientes usa o esquema padrão mcpServers:

{
  "mcpServers": {
    "chiplab": {
      "type": "http",
      "url": "https://chiplab.veecle.ai/mcp"
    }
  }
}

No primeiro uso, seu cliente abre um navegador para fazer login. Para verificar, peça ao seu agente para chamar a ferramenta de descoberta/ajuda do Chiplab sem argumentos.

Claude Code

Se você clonou este repositório, o servidor já está configurado via .mcp.json — o Claude Code pedirá que você confie nele. Caso contrário:

claude mcp add --transport http chiplab https://chiplab.veecle.ai/mcp
Claude Desktop / Cursor

Use o bloco mcpServers acima em claude_desktop_config.json ou .cursor/mcp.json.

VS Code

Mesmo bloco em .vscode/mcp.json, mas sob uma chave servers em vez de mcpServers.

Codex

TOML em ~/.codex/config.toml:

[mcp_servers.chiplab]
url = "https://chiplab.veecle.ai/mcp"

Então faça login com codex mcp login chiplab.

Como funciona

O contrato é independente de framework: seu agente compila um ELF → envia → executa na placa alvo → lê a saída UART capturada. As execuções retornam de forma síncrona e são limitadas a uma quantidade fixa de tempo virtual.

Este repositório inclui um exemplo pronto para execução para cada placa suportada, agrupado por framework — bare-metal (Rust, HAL do fornecedor), embassy-rust (Embassy assíncrono), zephyr-os (Zephyr RTOS, C), freertos (FreeRTOS, C) e threadx (Eclipse ThreadX, C). A matriz completa de placas × frameworks está em supported-boards.md.

Os detalhes da cadeia de ferramentas e da compilação estão no diretório de cada framework (examples/<framework>/README.md para humanos, AGENTS.md para agentes) — seu agente os encontra sozinho. Prefere compilar manualmente? Cada README de framework tem os comandos exatos.

Para executar seu próprio firmware, compile um ELF para uma placa suportada e peça ao seu agente para enviar e executar da mesma forma.

Contribuindo

Adicionar um exemplo de placa é a forma mais fácil de contribuir: espelhe um exemplo existente para o mesmo framework e adicione uma linha em supported-boards.md. Todas as convenções estão em AGENTS.md e no AGENTS.md de cada framework. Suporte a novos chips, sistemas operacionais ou periféricos é do lado do servidor — abra uma solicitação em vez de adicionar um exemplo para uma placa não suportada.

Encontrou um bug? Falta um chip? Conte-nos aqui.

Este é o lar público do Chiplab — bugs, ideias de recursos e solicitações de chips/SO/periféricos pertencem às issues deste repositório. As solicitações realmente moldam o roadmap — veja veecle.ai/roadmap para o que está planejado, ou venha dizer oi no Discord.

Licença

MIT © 2026 Veecle GmbH.