← 返回 Skills 市场
mars720816

FreeCAD MCP

作者 mars720816 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
329
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install openclaw-freecad-mcp
功能描述
Control FreeCAD via MCP to create and modify 3D models, automate CAD tasks, solve constraints, and integrate part libraries programmatically.
安全使用建议
This skill appears to implement a legitimate FreeCAD MCP server, but review the following before installing: - Arbitrary-code execution: The RPC API includes execute_code which will run Python inside your FreeCAD process. Only use this on a trusted machine, restrict network access to localhost, and avoid exposing the RPC port to untrusted networks. - Documentation mismatch: SKILL.md shows the MCP endpoint at port 9876 but client code uses 9875. Verify the actual port and configuration before connecting agents. - Examples reference external tools/keys (uv/uvx, GROQ_API_KEY, LLM models) that are not required by the addon itself — don’t provide unrelated API keys unless you understand why an example needs them. - Installation writes into your FreeCAD Mod directory; inspect the addon files locally before copying them and consider running inside an isolated environment or VM if you want to be cautious. If you plan to use this skill, audit/limit which agents can connect to the RPC server, and avoid running it on machines with sensitive data or exposed network services.
功能分析
Type: OpenClaw Skill Name: openclaw-freecad-mcp Version: 1.0.0 The skill bundle provides a bridge to control FreeCAD via MCP but includes a highly dangerous `execute_code` tool in `src/freecad_mcp/server.py` and `addon/FreeCADMCP/rpc_server/rpc_server.py` that allows for arbitrary Python execution using `exec()`. While documented as a feature for complex CAD operations, this capability presents a significant Remote Code Execution (RCE) risk if the AI agent is targeted by prompt injection. Additionally, the XML-RPC server used for communication between the MCP bridge and FreeCAD lacks authentication, relying solely on its binding to localhost.
能力评估
Purpose & Capability
Name/description match the included files: this package implements an MCP RPC server, FreeCAD addon, and client bindings for agents. However documentation and examples reference additional tooling (uv / uvx, uvx/clawhub steps, and LLM integrations) that are not declared as requirements, and SKILL.md instructs the agent to point to port 9876 while the client code uses port 9875 — a documentation/port mismatch that can cause confusion.
Instruction Scope
The RPC API intentionally exposes execute_code which runs exec(code, globals()) inside the FreeCAD process; README and RPC code advertise this feature. While this is coherent with 'programmatic control' of FreeCAD, it is a powerful operation that lets any client that can connect to the RPC server execute arbitrary Python on the host (file I/O, network, launching processes). SKILL.md does not prominently warn about this risk. The addon code also reads/writes files in the user's FreeCAD Mod / appdata paths and writes temporary screenshot files.
Install Mechanism
No automated download/install spec in the registry entry; installation is manual (copy addon to FreeCAD Mod directory) or via clawhub/npn instructions in SKILL.md. No external archive downloads or obscure URLs appear in the package. This is a lower install risk, though manual file writes to the FreeCAD Mod path are required.
Credentials
The skill declares no required environment variables or credentials (consistent). Example client code references unrelated keys (e.g., GROQ_API_KEY) and external LLM models, but those are examples for the agent environment and are not required by the FreeCAD addon itself. This may confuse non-technical users; the skill does not justify third-party API keys in its top-level requirements.
Persistence & Privilege
always:false and no special platform privileges requested. The skill runs an RPC server inside FreeCAD and relies on the agent connecting to it; this is expected. Note that autonomous agent invocation is allowed by default — combined with the execute_code capability, that increases the potential blast radius if an agent is configured to call this tool without oversight.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install openclaw-freecad-mcp
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /openclaw-freecad-mcp 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of FreeCAD MCP Skill. - Enables AI agents to control FreeCAD using the Model Context Protocol (MCP) - Supports automated creation of 3D models, part generation from descriptions, and constraint solving - Integrates with LangChain and Google ADK agents - Includes instructions for installing the FreeCAD addon and starting the RPC server - Provides example prompts and agent configurations for rapid setup
元数据
Slug openclaw-freecad-mcp
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

FreeCAD MCP 是什么?

Control FreeCAD via MCP to create and modify 3D models, automate CAD tasks, solve constraints, and integrate part libraries programmatically. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 329 次。

如何安装 FreeCAD MCP?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-freecad-mcp」即可一键安装,无需额外配置。

FreeCAD MCP 是免费的吗?

是的,FreeCAD MCP 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

FreeCAD MCP 支持哪些平台?

FreeCAD MCP 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 FreeCAD MCP?

由 mars720816(@mars720816)开发并维护,当前版本 v1.0.0。

💬 留言讨论