MF

mfrostbutter/fusion-cad-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

32 stars 5 forks 质量 83 趋势 19MIT

Autodesk Fusion 的类型化 MCP 工具。Fusion API 上的 75 个命名工具:草图、特征、装配、接合、测量、导出。

概览

一个MCP服务器,为Autodesk Fusion提供一个命名、带有类型的工具表面:create_sketch、挤出、add_hole、create_joint、导出,以及70个其他。 Fusion 自带 MCP 服务器,但它暴露了四个广泛工具,这些工具都使用原始 Python。这很有效,也意味着每次调用都可能出错 Fusion API。它放在 API 前面,将常用操作变成带有结构化错误的验证工具,这样代理就能在上下文中完成 CAD,而无需具备大量文笔技能。 75个工具,467次测试,以及对Fusion 2704.1.23的完整实时验证,发现并修复了17个错误。用于参数化零件设计的生产环境。 - Autodesk Fusion,运行中,设计已开启 - 启用 - Python 3.11+ 先从 AI-SETUP-PROMPT.md 开始。把一个提示粘贴到 Claude 里,它会一步步带你完成整个过程,安装到第一次拉伸,并验证是否成功。 然后用你的MCP客户端对准它。对于Claude Code或Claude Desktop: 参见“CONNECT”。

概述(AI 翻译)

一个MCP服务器为Autodesk Fusion提供命名、带有类型的工具表面:create_sketch、extrude、add_hole、create_joint、export,以及另外70个。

Fusion 自带 MCP 服务器,但它暴露了四个广泛工具,这些工具都使用原始 Python。这很有效,也意味着每次调用都可能出错 Fusion API。它放在 API 前面,将常用操作变成带有结构化错误的验证工具,这样代理就能在上下文中完成 CAD,而无需具备大量文笔技能。

状态:beta(0.2.x)。 75个工具,467次测试,以及对Fusion 2704.1.23的全面实时验证,发现并修复了17个漏洞。用于参数化零件设计的生产环境。

要求

  • Autodesk Fusion,运行中,设计已打开
  • 启用通用> > API > Fusion MCP 服务器
  • Python 3.11+

安装

不是开发者? 先从 AI-SETUP-PROMPT.md 开始。把一个提示粘贴到 Claude,它会一步步带你完成整个过程,安装到首次拉伸,并验证是否成功。

然后用你的MCP客户端对准它。对于Claude Code或Claude Desktop:

请参见 CONNECT.md 了解每个客户的详细信息和故障排除。

它是如何运作的

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

fusion-cad-mcp

An MCP server that gives Autodesk Fusion a named, typed tool surface: create_sketch, extrude, add_hole, create_joint, export, and 70 more.

Fusion ships its own MCP server, but it exposes four broad tools that take raw Python. That works, and it means every call is an opportunity to get the Fusion API wrong. This sits in front of it and turns the common operations into validated tools with structured errors, so an agent can do CAD without carrying a large prose skill in context.

Status: beta (0.2.x). 75 tools, 467 tests, and a full pass of live verification against Fusion 2704.1.23 that found and fixed 17 bugs. Used in production for parametric part design.

Requirements

  • Autodesk Fusion, running, with a design open
  • Preferences > General > API > Fusion MCP Server enabled
  • Python 3.11+

Install

Not a developer? Start with AI-SETUP-PROMPT.md. Paste one prompt into Claude and it walks you through the whole thing, install to first extrude, and verifies it worked.

pip install "fusion-cad-mcp @ git+https://github.com/Mfrostbutter/fusion-cad-mcp.git"

Then point your MCP client at it. For Claude Code or Claude Desktop:

{
  "mcpServers": {
    "fusion": {
      "command": "fusion-cad-mcp"
    }
  }
}

See CONNECT.md for per-client details and troubleshooting.

How it works

MCP client (Claude, Cursor, Cline, ...)
  -> fusion-cad-mcp            this package, stdio MCP server
    -> httpx
      -> 127.0.0.1:27182/mcp   Fusion's own MCP
        -> adsk.fusion / adsk.core

Each tool generates a Python script and runs it through Fusion’s execute. It is a peer of Autodesk’s bridge, not a replacement, so anything you can do in the Fusion API you can still do here via the execute escape hatch.

The tools

75 registered, 74 usable. Full reference with signatures, enums, return keys, and error codes is in tools.md, or search it in place with the find_tool tool.

Group Tools
Document and state doc_state, list_open_docs, list_projects, search_docs, open_doc, save, save_as, close, undo, redo
Parameters add_parameters, update_parameter, list_parameters
Sketch create_sketch, add_line, add_rectangle, add_circle, add_arc, add_ellipse, add_spline, add_polygon, add_geometric_constraint, add_dimension, assert_profiles, probe_sketch_dimensions, edit_sketch_dimension
Construction create_construction_plane, create_construction_axis, create_construction_point, delete_construction
Features extrude, revolve, combine, shell, add_hole, fillet_edges_by_geometry, chamfer_edges_by_geometry, mirror_feature, pattern_rectangular, pattern_circular, move_body, rebuild_feature
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "fusion": { "command": "fusion-cad-mcp" } } }