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)
[](CHANGELOG.md)
[](packages/addin)
[](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).
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessOutdated data