Skip to main content
Glama
ai-drawer
by ils15
README.md
# ai-drawer

Leva um LLM rodando no [OpenCode](https://opencode.ai/) até o Autodesk Fusion 360 via MCP: esboçar, modelar e inspecionar o documento aberto por conversa. Alpha.

[![License: MIT](https://img.shields.io/badge/license-MIT-yellow)](LICENSE)
[![Status](https://img.shields.io/badge/status-alpha-orange)](CHANGELOG.md)
[![Python](https://img.shields.io/badge/add--in-Python-3776ab)](packages/addin)
[![TypeScript](https://img.shields.io/badge/bridge-TypeScript-3178c6)](packages/bridge)

## O que é

O Fusion 360 expõe uma API Python rica, mas nada que um LLM possa operar sem risco. O ai-drawer é uma suíte de três peças que só funciona junta: o add-in `AutodeskFusionMCP` roda dentro do Fusion e despacha cada chamada `adsk.*` para a thread principal; o pacote `ai-drawer-mcp` é o servidor MCP stdio que o OpenCode inicia e que fala HTTP com o add-in; e a skill em `skill/ai-drawer/` é o manual que o LLM lê para conduzir a ferramenta.

A superfície é curada e tem 36 ferramentas — 34 servidas pelo add-in em oito categorias e duas respondidas pelo bridge (`fusion_health`, `list_tool_categories`). Não existe `execute_python`, chamador genérico de API nem armazenamento de user-script: nomes fora do conjunto curado são recusados e registrados.

Ela cobre o ciclo texto→CAD (esboço, extrusão ou revolução, fillet, padrão, aparência) e a inspeção do resultado, mas **não** cobre desenhos 2D: a API de drawing/sheet não está exposta. O alpha é honesto quanto a isso — viewport, seleção e documentação foram exercitados contra um Fusion real no Windows; os grupos mais novos são cobertos pela suíte automatizada com Fusion mockada e pelo harness de smoke em [`packages/addin/tests/smoke/`](packages/addin/tests/smoke/README.md).

## Instalação

O add-in roda dentro do Fusion; o bridge roda onde o OpenCode está. Nenhum dos dois precisa de conta ou serviço externo.

```bash
# 1. add-in: copie packages/addin para
#    %APPDATA%\Autodesk\Autodesk Fusion 360\API\AddIns\AutodeskFusionMCP
#    (mantenha o nome da pasta) e, no Fusion, Shift+S → Add-Ins → AutodeskFusionMCP → Run

# 2. bridge (Node 20 ou mais novo)
cd packages/bridge
npm install
npm run build     # gera dist/bin.js
```

Instruções completas, com tabela "qual é o meu setup?" e solução de problemas: [`docs/INSTALL.md`](docs/INSTALL.md). Para OpenCode no WSL com Fusion no host Windows há uma pegadinha de rede em [`docs/WSL-NETWORKING.md`](docs/WSL-NETWORKING.md); se você já usa o add-in do Frank Hommers, veja [`docs/COEXISTENCE.md`](docs/COEXISTENCE.md) (ambos usam a mesma porta por padrão).

## Uso

Registre o bridge como servidor MCP local na configuração do OpenCode:

```json
{
  "mcpServers": {
    "ai-drawer": {
      "type": "local",
      "command": ["node", "/caminho/absoluto/packages/bridge/dist/bin.js"],
      "enabled": true
    }
  }
}
```

Com o add-in em execução (`http://127.0.0.1:8765/health`), peça em linguagem natural — por exemplo, esboçar um retângulo na base, extrudar 10 mm, aplicar fillet e depois conferir o resultado. Variáveis `FUSION_MCP_HOST` e `FUSION_MCP_PORT` só são necessárias quando Fusion e OpenCode não compartilham o loopback.

## Estrutura

| Caminho | Papel |
| --- | --- |
| `packages/bridge/` | bridge stdio→HTTP em TypeScript, pacote `ai-drawer-mcp` |
| `packages/addin/` | add-in Python que roda dentro do Fusion como `AutodeskFusionMCP` |
| `skill/ai-drawer/` | skill que o LLM lê |
| `docs/` | instalação, rede WSL, sincronização com o upstream, coexistência |

## Licença

MIT — veja [`LICENSE`](LICENSE) e [`NOTICE.md`](NOTICE.md); o add-in é derivado do [`autodesk-fusion-mcp`](https://github.com/frankhommers/autodesk-fusion-mcp) de Frank Hommers (MIT), e o procedimento de sincronização com o upstream está em [`docs/UPSTREAM-MERGE.md`](docs/UPSTREAM-MERGE.md).