mcpField
C
cad-mcp-setup

cad-mcp-setup

github.com/earthtojakeAgent workflows23.9k148 installsUpdated today
Repository

About cad-mcp-setup

cad-mcp-setup is a setup guide skill for the CAD viewer used with agent apps. It checks for uv and explains how CAD appears or connects in supported apps, without installing software or changing projects.

Key features

  1. 01Checks whether uv is available
  2. 02Explains app-specific CAD setup
  3. 03Troubleshoots viewer startup
  4. 04Covers MCP server connection status

Use cases

  1. 01Prepare CAD for use in Codex
  2. 02Configure CAD with Claude Desktop
  3. 03Check a Claude Code connection
  4. 04Resolve a viewer startup issue

MCP support

The skill explains how apps start or configure CAD's MCP server and how to check its connection. CAD can display models as viewer cards in apps that support MCP Apps.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/earthtojake/text-to-cad --skill cad-mcp-setup

After installing, type/cad-mcp-setupin Claude Code to confirm it loaded.

Bundled filesagents/openai.yamlLICENSE

Details

From the project README

Set up CAD

Provenance: maintained in earthtojake/text-to-cad. Use the installed local skill files as the runtime source of truth; the repository link is only for provenance and release review.

CAD's viewer is a local server that the agent app starts with uvx, pinned to one release of cadgen. The app downloads that release from PyPI the first time the server starts after an install or an update, so that start needs a network connection. This skill only checks and explains: it installs nothing, downloads nothing, and changes nothing in the user's projects.

Steps

  1. Check for uv:

    uv --version

  2. If uv is missing, tell the user CAD needs it, and give them uv's official installation guide to install it themselves: https://docs.astral.sh/uv/getting-started/installation/.

  3. Tell the user how CAD appears in their app:

    • Codex: quit and reopen Codex. CAD then appears in the sidebar and as a tab in each thread.
    • Claude Code: the plugin starts CAD with each session; /mcp shows whether it is connected. Where Claude Code can show app views, CAD shows models as viewer cards; otherwise, as in a terminal, it answers with a link that opens the model in the CAD Viewer in the browser.
    • Claude Desktop: the plugin doesn't reach Claude Desktop. The user adds CAD's server to its config (Settings > Developer > Edit Config), as the text-to-cad README shows, and restarts it. CAD then shows models as viewer cards in the chat.
    • Another app that shows MCP Apps (VS Code, Cursor, Goose): CAD shows models as viewer cards in the chat once the app restarts.

When the viewer does not start

  • uv or uvx not found after installing uv: the app reads the login shell's PATH, so confirm uv --version in a new shell, then restart the app. In Claude Desktop's config, the full path to uvx (which uvx) also works.
  • No network on the first start after an install or an update: the pinned runtime could not be fetched. Restart the app once online.
  • Claude Code gives a server 30 seconds to start, and the first start downloads CAD's libraries (about 1 GB unpacked). On a slow connection, start Claude Code once with MCP_TIMEOUT=300000 claude so the download can finish.
  • After a plugin update, restart the app: the first start fetches the new pinned runtime, which can take a few minutes on a slow connection. In Codex, threads started before the update keep the old one until the restart.

Comments

Markdown supported