Sean P. KaneandGitHub
6a6cad9e65
* FreeCAD addon support for Workbench and Plugins * docs: refactor docs and clean up linters, etc. * Remove mdformat * test: improve test coverage * test:Lots of general fixes * chore: more general fixes
87 lines
2.7 KiB
Python
Executable File
87 lines
2.7 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
r"""Headless FreeCAD MCP Bridge Server.
|
|
|
|
SPDX-License-Identifier: MIT
|
|
Copyright (c) 2025 Sean P. Kane (GitHub: spkane)
|
|
|
|
This script starts the MCP bridge server in FreeCAD's headless mode.
|
|
It should be run with FreeCADCmd (the headless FreeCAD executable).
|
|
|
|
Usage:
|
|
# If workbench is installed via FreeCAD Addon Manager:
|
|
FreeCADCmd ~/.local/share/FreeCAD/Mod/FreecadRobustMCP/freecad_mcp_bridge/headless_server.py
|
|
|
|
# On macOS:
|
|
/Applications/FreeCAD.app/Contents/Resources/bin/freecadcmd \
|
|
~/Library/Application\ Support/FreeCAD/Mod/FreecadRobustMCP/freecad_mcp_bridge/headless_server.py
|
|
|
|
Note: In headless mode, GUI features like screenshots are not available.
|
|
For full functionality, use the workbench in FreeCAD's GUI.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
# Check if we're running inside FreeCAD
|
|
try:
|
|
import FreeCAD
|
|
|
|
print(f"FreeCAD version: {FreeCAD.Version()[0]}.{FreeCAD.Version()[1]}")
|
|
except ImportError:
|
|
print("ERROR: This script must be run with FreeCADCmd or inside FreeCAD.")
|
|
print("")
|
|
print("Usage:")
|
|
print(
|
|
" FreeCADCmd /path/to/FreecadRobustMCP/freecad_mcp_bridge/headless_server.py"
|
|
)
|
|
print("")
|
|
print("On macOS (if workbench installed):")
|
|
print(" /Applications/FreeCAD.app/Contents/Resources/bin/freecadcmd \\")
|
|
print(
|
|
" ~/Library/Application\\ Support/FreeCAD/Mod/FreecadRobustMCP/"
|
|
"freecad_mcp_bridge/headless_server.py"
|
|
)
|
|
print("")
|
|
print("On Linux (if workbench installed):")
|
|
print(
|
|
" freecadcmd ~/.local/share/FreeCAD/Mod/FreecadRobustMCP/"
|
|
"freecad_mcp_bridge/headless_server.py"
|
|
)
|
|
sys.exit(1)
|
|
|
|
# Import the plugin server directly from the module file in the same directory
|
|
script_dir = str(Path(__file__).resolve().parent)
|
|
sys.path.insert(0, script_dir)
|
|
from server import FreecadMCPPlugin # noqa: E402
|
|
|
|
# Create and run the plugin
|
|
plugin = FreecadMCPPlugin(
|
|
host="localhost",
|
|
port=9876, # JSON-RPC socket port
|
|
xmlrpc_port=9875, # XML-RPC port
|
|
enable_xmlrpc=True,
|
|
)
|
|
|
|
# Start the plugin
|
|
plugin.start()
|
|
|
|
# Print status messages with flush to ensure they appear immediately
|
|
# (FreeCAD's Python may have buffered stdout)
|
|
print("", flush=True)
|
|
print("=" * 60, flush=True)
|
|
print("MCP Bridge started in headless mode!", flush=True)
|
|
print(" - XML-RPC: localhost:9875", flush=True)
|
|
print(" - Socket: localhost:9876", flush=True)
|
|
print("", flush=True)
|
|
print(
|
|
"Note: Screenshot and view features are not available in headless mode.", flush=True
|
|
)
|
|
print("Press Ctrl+C to stop.", flush=True)
|
|
print("=" * 60, flush=True)
|
|
print("", flush=True)
|
|
|
|
# Run forever (blocks until Ctrl+C)
|
|
plugin.run_forever()
|