mcpField
C
cad-mcp-setup

cad-mcp-setup

github.com/earthtojakeAgent 工作流23.9k148 次安装今天更新
代码仓库

关于 cad-mcp-setup

cad-mcp-setup 是用于在 Agent 应用中设置 CAD 查看器的指南技能。它会检查 uv 并说明 CAD 在相关应用中的显示或连接方式，但不会安装软件或修改项目。

主要功能

  1. 01检查是否存在 uv
  2. 02说明各应用的 CAD 设置
  3. 03排查查看器启动问题
  4. 04涵盖 MCP 服务连接状态

适用场景

  1. 01在 Codex 中准备使用 CAD
  2. 02在 Claude Desktop 配置 CAD
  3. 03检查 Claude Code 的连接
  4. 04解决查看器启动问题

MCP 相关

该技能说明应用如何启动或配置 CAD 的 MCP 服务，以及如何检查连接状态。支持 MCP Apps 的应用可将模型显示为查看器卡片。

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/cad-mcp-setup确认已加载。

附带文件agents/openai.yamlLICENSE

详细介绍

设置 CAD

来源：维护于 earthtojake/text-to-cad。 请以已安装的本地技能文件作为运行时事实来源；仓库链接仅用于追溯来源和审核发布版本。

CAD 的查看器是一个本地服务，由 Agent 应用通过 uvx 启动，并固定使用一个版本的 cadgen。安装或更新后，应用会在服务首次启动时从 PyPI 下载该版本，因此首次启动需要网络连接。此技能仅进行检查和说明：不会安装或下载任何内容，也不会更改用户的项目。

步骤

  1. 检查是否已安装 uv：

    uv --version

  2. 如果未安装 uv，告知用户 CAD 需要 uv，并提供 uv 的官方安装指南，让用户自行安装： https://docs.astral.sh/uv/getting-started/installation/.

  3. 告知用户 CAD 在其应用中的显示方式：

    • Codex：退出并重新打开 Codex。随后 CAD 会显示在侧边栏中，也会作为标签页显示在每个对话中。
    • Claude Code：插件会在每次会话中启动 CAD；/mcp 会显示连接状态。如果 Claude Code 能显示应用视图，CAD 会以查看器卡片的形式显示模型；否则（例如在终端中），它会回复一个链接，点击后可在浏览器中的 CAD Viewer 打开模型。
    • Claude Desktop：该插件无法连接到 Claude Desktop。用户需按照 text-to-cad README 中的说明，将 CAD 服务添加到其配置中（Settings > Developer > Edit Config），然后重启应用。随后，CAD 会在聊天中以查看器卡片的形式显示模型。
    • 其他可显示 MCP Apps 的应用（VS Code、Cursor、Goose）：应用重启后，CAD 会在聊天中以查看器卡片的形式显示模型。

查看器无法启动时

  • 安装 uv 后仍找不到 uv 或 uvx：应用会读取登录 Shell 的 PATH，因此请在新 Shell 中确认 uv --version，然后重启应用。在 Claude Desktop 的配置中，也可以使用 uvx 的完整路径（which uvx）。
  • 安装或更新后首次启动时没有网络：无法获取固定版本的运行时。请在联网后重启应用。
  • Claude Code 会等待服务启动，最长 30 秒；首次启动时会下载 CAD 的库（解压后约 1 GB）。如果网速较慢，请使用 MCP_TIMEOUT=300000 claude 启动一次 Claude Code，以便完成下载。
  • 插件更新后，请重启应用：首次启动时会获取新的固定版本运行时，网速较慢时可能需要几分钟。在 Codex 中，更新前启动的对话会继续使用旧版本，直到重启应用。

评论

支持 Markdown