Freecad Mcp Functional Print Designer

FreeCAD MCP Functional Print Designer

Codex/OpenAI skill for designing functional, 3D-printable FreeCAD parts through the freecad MCP server.

Format

This repository is already in the correct skill format:

• SKILL.md: skill entrypoint and loading rules
• agents/openai.yaml: UI metadata
• references/: local reference material and curated wiki extracts
• scripts/: maintenance scripts, including wiki extract refresh

Requirements

• An agent runtime that supports SKILL.md-based skills
• A configured MCP tool named freecad
• FreeCAD available through the neka-nat/freecad-mcp server or an equivalent compatible server

Install For Codex / OpenAI Agents

Clone the repo anywhere, then symlink it into your skills directory.

git clone  /path/to/freecad-mcp-functional-print-designer
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
ln -s /path/to/freecad-mcp-functional-print-designer \
  "${CODEX_HOME:-$HOME/.codex}/skills/freecad-mcp-functional-print-designer"

If your environment does not use CODEX_HOME, the default skills directory is usually ~/.codex/skills.

If you already have the repository locally, you only need the symlink step:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
ln -s /absolute/path/to/freecad-mcp-functional-print-designer \
  "${CODEX_HOME:-$HOME/.codex}/skills/freecad-mcp-functional-print-designer"

Example for this repository when it lives under ~/Builds/freecad:

mkdir -p ~/.codex/skills
ln -s ~/Builds/freecad/freecad-mcp-functional-print-designer \
  ~/.codex/skills/freecad-mcp-functional-print-designer

After creating the symlink, restart Codex or refresh the Skills view so the skill is discovered. If the Skills tab still looks empty, clear any search filter before checking again.

To verify the install from a shell:

ls -la ~/.codex/skills
readlink ~/.codex/skills/freecad-mcp-functional-print-designer

Using a symlink is recommended because edits in the repository are picked up without reinstalling the skill.

Install For Other Agent Setups

If your agent uses a different skills root, symlink or copy this repository into that skills directory under the folder name freecad-mcp-functional-print-designer.

Example:

mkdir -p ~/.agents/skills
ln -s /path/to/freecad-mcp-functional-print-designer \
  ~/.agents/skills/freecad-mcp-functional-print-designer

Verify

After installation, the skill should be discoverable as:

$freecad-mcp-functional-print-designer

It also expects the freecad MCP dependency declared in agents/openai.yaml to be available at runtime.

Refresh Wiki Extracts

To rebuild the curated FreeCAD wiki references:

./scripts/fetch_freecad_wiki_extracts.py

This regenerates:

• references/wiki-extracts-index.md
• references/wiki-extracts/*.md

Notes

• The skill is MCP-first. It is written so the agent performs the CAD actions; the user should not have to click through FreeCAD.
• The raw wiki material is not on the default path. The skill opens it only for narrow, exact-option lookups.

License

MIT. See [LICENSE](LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: pgrignaffini
• Source: pgrignaffini/freecad-mcp-functional-print-designer
• License: MIT

Install and usage instructions live in the source repository linked above.