CAD Agent Foundation
Servidor MCP local do AutoCAD e CLI para agentes de IA, usando uma API nativa .NET para desenho 2D limitado, anotação, dimensões e edição com verificações de identidade do desenho e verificação de gravação/salvamento; Windows x64 e AutoCAD 2026 compatível são necessários.
Documentação
CAD Agent Foundation — Ponte MCP e CLI do AutoCAD para Agentes de IA
MCP do AutoCAD priorizando agentes — construído para o ciclo de execução, não apenas para chamadas de comando. O CAD Agent Foundation ajuda agentes de IA a vincular o desenho correto, rastrear cada solicitação, receber feedback de execução, verificar o que foi gravado ou salvo e continuar trabalhos CAD de múltiplas etapas com confiança. Skills de CAD independentes ou de terceiros podem reutilizar esta base de execução para seus próprios fluxos de trabalho profissionais.
中文简介：面向 AI Agent 的 CAD 执行底座——不止调用命令，还关注图纸绑定、执行反馈、结果核验与安全续作，可与第三方专业 Skill 组合使用。
Embora as integrações CAD conectem a IA a comandos e dados de desenho, a Foundation concentra-se no fluxo de trabalho do agente em torno de cada operação: saber o que foi solicitado, o que realmente aconteceu e se o próximo passo é seguro.
Prévia pública do código-fonte v1.1.0-rc.1 (operações nativas limitadas e prévia do runtime Windows). Código-fonte, documentação e um ZIP de runtime Windows com manifesto são fornecidos nesta prévia. Pré-requisitos de build e limites. O runtime local aceito v1.0.0-local é uma linha de base separada. As prévias das Skills complementares são publicadas de forma independente: callout v0.3.0-rc.1 e distress v0.1.0-rc.1.
简体中文 · Início rápido · Recursos · Compatibilidade
Servidor MCP registrado: io.github.capskov/cad-agent-foundation. Instalação e descoberta do MCPB · Metadados do registro. Os pré-requisitos locais de Windows/AutoCAD ainda se aplicam; o registro não concede acesso a desenhos.
Ponte de automação do AutoCAD para agentes de IA via MCP e CLI, usando uma API .NET nativa.
Agentes de IA podem inspecionar e operar um desenho AutoCAD ativo por meio de ferramentas nativas estruturadas para geometria 2D limitada, texto, hachuras e callouts. A ponte usa MCP (Model Context Protocol) e CLI; verificações de identidade do desenho e verificação de gravação/salvamento regem as operações suportadas.
O CAD Agent Foundation oferece aos agentes CAD um contrato de execução limitado: vincular explicitamente um desenho, persistir a propriedade da solicitação e o estado de execução, inspecionar a solicitação original após uma resposta incerta e verificar fatos de objetos rastreados após gravações e salvamentos. A implementação atual integra esses mecanismos a um host Bimwright DWG MCP modificado e fixado.
Esta ponte Windows/AutoCAD é mantida por capskov. A prévia atual é v1.1.0-rc.1, com um ZIP de runtime construído de forma independente e evidências nativas limitadas. A linha de base aceita v1.0.0-local é mantida; não é reivindicada compatibilidade com todas as atualizações do AutoCAD.
Por que este projeto existe
O projeto surgiu do trabalho CAD em engenharia rodoviária e civil: criar limites, preenchimentos, quantitativos e callouts vinculados, e depois revisá-los e salvá-los em uma longa sessão de agente. Um comando de desenho útil é apenas parte desse fluxo de trabalho. O agente também precisa saber qual desenho possui, se uma modificação já ocorreu, o que permanece não verificado e se outra tentativa o duplicaria.
O design concentra-se nessas decisões. Registros duráveis, identidade do desenho e leitura nativa adicionam sobrecarga; nenhuma vantagem comparativa de velocidade, custo de token ou produtividade foi estabelecida. Julgamento de engenharia e regras de layout específicas do domínio permanecem em Skills separadas.
Operações nativas e instalação
Baixe o runtime v1.1.0-rc.1, verifique o SHA256SUMS.txt e extraia a pasta completa. Requer AutoCAD 2026 x64 Windows compatível licenciado, .NET 8 Desktop Runtime e Python 3.11+. Nenhum assembly da Autodesk ou fontes SHX são redistribuídos. Instalação · Catálogo de 25 operações · Nova validação.
Novo nesta prévia: estilos de texto com fontes instaladas, estilos de cota, DIMENSION nativo linear/alinhado/raio/diâmetro, gerenciamento de estado de camadas, continuação protegida de limite fechado/hachura, geometria/formato de callout vinculado e rotação/escala/cópia no mesmo desenho de grupos completos suportados. Preserva a reconciliação da solicitação original e a proteção de desenho/objeto.
Visão geral dos recursos atuais
Maturidade: o runtime local limitado tem evidências nativas de aceitação; o lançamento fornece um ZIP de runtime com licenças de dependências, hashes de arquivos e MVID de plugins; os pré-requisitos permanecem instalados separadamente. O suporte segue o perfil realmente exposto.
| Categoria | Recursos atuais | Status / limites |
|---|---|---|
| Desenho básico | Nova camada, linha, círculo, polilinha 2D e hachura associativa em um novo limite anterior | Fluxos de trabalho locais especificados verificados; não é edição arbitrária/todos os casos de hachura. |
| Texto e callouts | DBText de linha única, MText de múltiplas linhas, grupo comum LEADER/MText/ponto preenchido amarelo | Criação verificada; estilos/posicionamento completos do domínio pertencem à Skill. |
| Edições / gerenciamento de objetos | Atualização de texto vinculado protegida por digest e mover/arquivar grupo completo de callout | Fluxo de trabalho de grupo especificado verificado; nem toda ramificação de entidade é testada individualmente. |
| Execução / entrega | Vinculação de desenho, consultas de solicitação original, proteções contra duplicação e salvamento/leitura de disco do documento inteiro | Fluxos de trabalho locais verificados; sem reprodução automática de gravação desconhecida/desbloqueio. |
| Leituras / auxiliares | Propriedades/digests de entidades, lista de camadas, paginação filtrada e inspeção estática de Lisp | Leitura de entidades verificada; algumas outras rotas implementadas carecem de prova individual de ponta a ponta na versão atual. |
| Operações limitadas adicionais | Quatro tipos nativos de DIMENSION, estilos correspondentes nomeados, estados de camadas, atualizações de limite fechado/callout, rotação/escala/cópia | Consulte o catálogo de 25 operações para proteções exatas e evidências nativas limitadas. |
| Não expostos | MLEADER, sobrescrita de estilo compartilhado, edição arbitrária de objetos, Boolean/furos complexos, edições de layout/plotagem/xref | Sem cobertura abrangente de cada objeto nativo ou comando upstream. |
Interfaces completas, invocação e status de verificação por item. A Foundation fornece operações nativas reutilizáveis, restrições de execução, status e gerenciamento de objetos. Skills mantidas independentemente fornecem regras de domínio, parâmetros de estilo, algoritmos de posicionamento e fluxos de trabalho por meio das interfaces reais suportadas da Foundation. Compatibilidade nativa/backend ausente não é fornecida apenas pela instalação de uma Skill.
Contrato de execução
Vincule o desenho pretendido e verifique a identidade do processo/sessão/plugin. Persista uma solicitação estável antes do envio; após uma resposta incerta, consulte essa solicitação original. Edições existentes precisam de digests nativos novos e associações completas. Confirme efeitos, leitura independente e liberação de cerca separadamente; salvar cobre todo o desenho de trabalho. Consulte arquitetura e catálogo de interfaces versionado.
Escolha componentes por tarefa
| Tarefa | Componentes necessários | Versões e limites |
|---|---|---|
| Operações CAD básicas suportadas | Somente cad-agent-foundation | Linha de base local v1.0.0-local; prévia pública do código-fonte v1.1.0-rc.1, com um ZIP de runtime revisado; pré-requisitos são separados. Operações 2D limitadas; gravações atuais exigem metros; somente host Windows/AutoCAD 2026 registrado. Nenhuma das Skills é necessária. |
| Estilo e posicionamento de callout deste projeto | Foundation + cad-callout-pair-layout | Skill pública de callout v0.3.0-rc.1 (regras existentes v0.3). Padrões rodoviários baseados em metros; interfaces nativas de estilo/pose e uma integração limitada sintética de Skill inalterada são verificadas na v1.1; cobertura completa de projetos reais/background permanece por tarefa. Verifique a cobertura do backend antes de gravar. |
| Fluxo de trabalho de distress/demolição deste projeto | Foundation + cad-distress-annotation + cad-callout-pair-layout | Prévia pública de regras de distress v0.1.0-rc.1. Requer evidências de engenharia, classificações e as regras de callout; o fluxo de trabalho completo precisa de recursos fora do perfil atual da Foundation e não é certificado apenas com esses três componentes. |
As duas Skills são opcionais para operações básicas. Suas regras não estão embutidas na Foundation; instalá-las não adiciona operações nativas ausentes. O código-fonte da Foundation e ambas as prévias independentes das Skills são públicos. Entradas de instalação, versões e verificações do agente.
Início rápido
Os comandos abaixo usam o ZIP de runtime extraído. Apenas o checkout do código-fonte requer build/empacotamento primeiro.
foundation.cmd install --workspace "C:\CAD-work\demo01"
foundation.cmd start --workspace "C:\CAD-work\demo01" --source "C:\drawings\input.dwg" --write
foundation.cmd doctor --workspace "C:\CAD-work\demo01"
foundation.cmd apply --workspace "C:\CAD-work\demo01" --plan "plan.json"
foundation.cmd save --workspace "C:\CAD-work\demo01" --handles RETURNED_HANDLES
foundation.cmd stop --workspace "C:\CAD-work\demo01"
Omita --write para uma sessão somente leitura. start cria uma cópia de trabalho; não sobrescreve o desenho de origem. Salvar afeta o desenho de trabalho inteiro, incluindo outras edições não salvas nessa instância. Leia o início rápido para tratamento de solicitações e um pequeno plano sintético.
Verificação e escopo
O lançamento local foi verificado em duas fontes de desenho diferentes, com coordenadas e handles diferentes. Cada fluxo de trabalho criou dez novos objetos, leu-os de forma independente, atualizou texto vinculado, moveu o grupo completo de callout, arquivou-o, salvou e fechou o desenho. Novas sessões CAD então leram os objetos salvos com digests nativos correspondentes. A entrada CLI/MCP e a extração/instalação local do pacote também foram verificadas.
Estes são resultados de fluxos de trabalho limitados em um ambiente Windows AutoCAD 2026 registrado. Eles não provam correção universal de desenhos, confiabilidade em produção, compatibilidade com todos os patches ou um agente geral de engenharia CAD. O resumo de validação separa evidências nativas de testes offline e registra honestamente resultados históricos não resolvidos.
Limites atuais
Os planos escrevem geometria 2D limitada no espaço do modelo. Coordenadas, comprimentos e tamanhos de anotação são expressos em unidades de desenho. WCS é a referência de coordenadas do CAD; não implica metros ou projeção de mapa. A Foundation não realiza projeção ou conversão de unidades.
A interface de gravação atual é restrita a metros: os planos exigem units: metres, e o desenho deve usar metros ou coordenadas adimensionais explicitamente baseadas em metros. Milímetros e outras unidades não são habilitados ou validados. Este limite de implementação não restringe a fundação pretendida a trabalhos rodoviários.
Este lançamento fornece quatro primitivas nativas de cota e atualizações limitadas de limite fechado/hachura única. Não fornece MLeader, reparo geral de hachura antiga/Boolean/furos, propriedades arbitrárias de polilinha, cópia entre desenhos, semântica de objetos proxy, layout/plotagem, decisões de engenharia ou recuperação automática/desbloqueio de gravações incertas. Uma operação confirmada não pode ser considerada revertida porque uma verificação posterior falhou.
A linha de base local .NET 8 foi inspecionada no AutoCAD R25.1.74.0.0. O AutoCAD 2026.1.2 introduziu uma transição .NET 10; a compatibilidade com esse host atualizado ainda não foi validada aqui. Consulte compatibilidade. Atualização de runtime da Autodesk
Skills separadas
Consulte o caso anônimo de demolição rodoviária para desenhos antes/depois existentes e referências de quantitativo/estação. Ele ilustra a saída das Skills complementares e não certifica uma execução somente da Foundation desse fluxo de trabalho completo.
Repositórios independentes de Skills e instalação:
- cad-callout-pair-layout: estilo de callout, restrições de margem rodoviária e orçamentos finitos de posicionamento; inclui Lisp manual BZYD bilíngue opcional. Instalar · v0.3.0-rc.1.
- cad-distress-annotation: limites de distress/demolição rodoviária baseados em evidências e regras de quantitativo. Instalar · v0.1.0-rc.1.
A Foundation fornece primitivas CAD suportadas e seu contrato de execução. As Skills decidem o que desenhar, como dispor e quais verificações de domínio aplicar. A Foundation não determina espécies de plantas, tratamento de distress ou quantitativos de engenharia.
Técnicas de callout também podem servir para plantio paisagístico e outras anotações classificadas de desenhos. As regras e padrões testados da Skill existente vêm de desenhos rodoviários baseados em metros; outras disciplinas ou desenhos em milímetros precisam de adaptação de estilo, tamanho e posicionamento e não são certificados aqui. Ambos os repositórios fornecem ZIPs de Skills públicos com versionamento e guias de instalação manual. A Foundation v1.1 adiciona as interfaces nativas de estilo/pose/medição; uma integração sintética de solver de Skill inalterado é registrada na nova validação, não uma certificação genérica de projeto real. Um fluxo de trabalho completo de Skill somente com Foundation não foi certificado. Callout v0.3.0-rc.1 e distress v0.1.0-rc.1 permanecem com versionamento independente. Consulte compatibilidade.
Trabalhando junto com outras ferramentas
Agentes podem usar outros servidores MCP ou ferramentas CAD separadamente. Somente operações suportadas enviadas por meio da Foundation entram no fluxo governado de solicitação, execução e verificação. Um backend não relacionado não compartilha automaticamente suas transações, identidades de solicitação ou cercas. Trocar de ferramenta não é uma forma de contornar uma escrita não resolvida. A cobertura completa de um backend externo exigiria uma integração explícita; ela não é fornecida por esta linha de base. Consulte Foundation, Skills e outras ferramentas.
Upstream e licenciamento
O AutoCAD 2026 é o host inicial validado porque corresponde ao ambiente de trabalho e à rota de plugin nativo adotada. A linha de base local .NET 8 usa bloqueio de documento, transações e leitura nativa; 2025 também tem um host .NET 8, e anos anteriores têm APIs de automação. O MCP vem da ponte. Consulte por que 2026.
O host integrado deriva do Bimwright DWG MCP, fixado em 4d0f756. Preserve seu licenciamento Apache-2.0 e atribuição. Outros projetos revisados são creditados separadamente do código realmente reutilizado; consulte contexto e projetos relacionados.
O caminho de desenvolvimento foi prático: examinar backends MCP CAD existentes em tarefas reais, integrar um contrato de execução limitado ao host nativo selecionado e, em seguida, verificar escritas, leitura nativa e desenhos salvos. Avaliações históricas são documentadas com seu escopo, em vez de apresentadas como uma classificação dos projetos atuais.
Esta prévia usa Apache-2.0, preservando avisos upstream e de origem MIT. Lançamentos anteriores de fonte/documentação v1.0.0-rc.1/rc.2 são mantidos; v1.1.0-rc.1 adiciona um ZIP de runtime revisado com textos de licença de dependências. Ativos do AutoCAD/SDK e SHX sem licença não são redistribuídos; Open Sans mantém OFL. Consulte decisão de licença e avisos.
Contribuições humanas e assistidas por IA são bem-vindas quando alterações e evidências de verificação são revisáveis. O mantenedor revisa merges e lançamentos. Consulte contribuindo.
AutoCAD e DWG são marcas registradas da Autodesk. Este projeto independente não é endossado pela Autodesk ou pelos mantenedores upstream.