convez.ai
MCP ServerAutomaçãoIntermediário
asmith26

JupyterCAD MCP

asmith26/jupytercad-mcp

Controle JupyterCAD com linguagem natural via agentes de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra JupyterCAD com LLMs, permitindo criar e manipular designs CAD através de linguagem natural. Fornece ferramentas para adicionar formas geométricas, gerenciar objetos e anotações em documentos CAD de forma programática.

Instalação

$npx convez-ai asmith26/jupytercad-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
20
Forks
4
Acompanhando
0
Saúde
42%
Último commit
há 1 ano
Versão
v0.1.1
Issues abertas
1
Contribuidores
1

Casos de uso

  • Gerar designs CAD automaticamente a partir de descrições textuais
  • Integrar CAD em pipelines de automação com LLMs
  • Criar protótipos 3D interativos via chat com IA

Veredito

Ferramenta bem implementada que democratiza o acesso a CAD programático através de agentes de IA. Ideal para automação de design e prototipagem rápida, com documentação clara e exemplos funcionais.

README

A tradução para o português deste README ainda está na fila.

jupytercad-mcp

An MCP server for JupyterCAD that allows you to control it using LLMs/natural language.

https://github.com/user-attachments/assets/7edb31b2-2c80-4096-9d9c-048ae27c54e7

Suggestions and contributions are very welcome.

Usage

The default transport mechanism is stdio. To start the server with stdio, use the following command:

uvx --with jupytercad-mcp jupytercad-mcp

To use the streamable-http transport, use this command instead:

uvx --with jupytercad-mcp jupytercad-mcp streamable-http

Example

An example using the OpenAI Agents SDK is available at examples/openai_agents_client.py. To run it, follow these steps:

  1. Clone the repository and navigate into the directory:

    git clone git@github.com:asmith26/jupytercad-mcp.git
    cd jupytercad-mcp
    
  2. Install the OpenAI Agents SDK. A Makefile target is provided for convenience:

    make setup-examples-env
    
  3. In examples/openai_agents_client.py, update line 13 to configure a MODEL (see supported models).

  4. Run JupyterLab from the project's root directory:

    make jupyter-lab
    
  5. In JupyterLab, create a new "CAD file" and rename it to my_cad_design.jcad. This file path matches the default JCAD_PATH in the example, allowing you to visualise the changes made by the JupyterCAD MCP server.

  6. (Optional) The OpenAI Agents SDK supports tracing to record events like LLM generations and tool calls. To enable it, set USE_MLFLOW_TRACING=True and run the MLflow UI:

    make mlflow-ui
    
  7. Run the example with the default instruction, "Add a box with width/height/depth 1":

    make example-openai-agents-client
    

Interactive Chat Interface

The example includes an interactive chat interface using the OpenAI Agents SDK's REPL utility. To enable it, set USE_REPL=True.

streamable-http

To use the streamable-http transport, first start the MCP server:

uvx --with jupytercad-mcp jupytercad-mcp streamable-http

Then, run the example with the TRANSPORT variable set to "streamable-http" in the client example.

Tools

The following tools are available:

  • get_current_cad_design: Reads the current content of the JCAD document.
  • remove: Remove an object from the document.
  • rename: Rename an object in the document.
  • add_annotation: Add an annotation to the document.
  • remove_annotation: Remove an annotation from the document.
  • add_occ_shape: Add an OpenCascade TopoDS shape to the document.
  • add_box: Add a box to the document.
  • add_cone: Add a cone to the document.
  • add_cylinder: Add a cylinder to the document.
  • add_sphere: Add a sphere to the document.
  • add_torus: Add a torus to the document.
  • cut: Apply a cut boolean operation between two objects.
  • fuse: Apply a union boolean operation between two objects.
  • intersect: Apply an intersection boolean operation between two objects.
  • chamfer: Apply a chamfer operation on an object.
  • fillet: Apply a fillet operation on an object.
  • set_visible: Sets the visibility of an object.
  • set_color: Sets the color of an object.
Ver o original no GitHub

Bom para

Relacionados