OCP Viewer MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
OCP Viewer MCP Server
An MCP (Model Context Protocol) server that captures screenshots from the OCP CAD Viewer, allowing AI assistants like Cursor to "see" your 3D CAD models.
What it does
When working with CAD tools like CadQuery or Build123d, you can display models in the OCP CAD Viewer using show(). This MCP server lets you ask an AI assistant to capture what's currently displayed, enabling visual feedback and AI-assisted CAD development.
Example workflow:
You're designing a part in a Jupyter notebook with CadQuery
You run
show(my_part)to display it in the OCP viewerYou ask the AI: "capture the current view - does this geometry look correct?"
The AI captures a screenshot and can analyze the 3D model visually
Related MCP server: FreeCAD MCP
Installation
pip install ocp-viewer-mcpRequirements:
Python 3.10+
OCP CAD Viewer VS Code/Cursor extension
ocp-vscode Python package (for
show()function)
Configuration
Cursor
Add to your ~/.cursor/mcp.json:
{
"mcpServers": {
"ocp-viewer": {
"command": "python",
"args": ["-m", "ocp_viewer_mcp.server"]
}
}
}If you're using a virtual environment (recommended), specify the full Python path:
{
"mcpServers": {
"ocp-viewer": {
"command": "/path/to/your/venv/bin/python",
"args": ["-m", "ocp_viewer_mcp.server"]
}
}
}Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"ocp-viewer": {
"command": "python",
"args": ["-m", "ocp_viewer_mcp.server"]
}
}
}Usage
Open your CadQuery/Build123d project in Cursor or VS Code
Start the OCP CAD Viewer (Cmd+Shift+P → "OCP CAD Viewer: Open Viewer")
Display a model using
show(your_model)in a notebook or scriptAsk the AI to capture the view:
"Capture the current OCP view"
"Show me what the model looks like"
"Take a screenshot of the CAD viewer"
Tool Reference
capture_ocp_screenshot
Captures a screenshot of the OCP CAD Viewer.
Parameter | Type | Default | Description |
| integer | 3939 | The port where OCP viewer is running |
| integer | 1000 | Milliseconds to wait for rendering |
Returns: A PNG screenshot as a base64-encoded image.
Troubleshooting
"Could not connect to OCP viewer"
Make sure the OCP CAD Viewer is open in VS Code/Cursor
Check that the viewer backend is running (look for "Viewer backend started" in terminal)
Verify the port (default is 3939)
"ocp_vscode not installed"
The MCP server needs ocp-vscode installed in the same Python environment:
pip install ocp-vscodeScreenshot not capturing
Make sure a model is displayed (run
show(something)first)Try increasing
wait_msif the model is complex
Development
# Clone the repo
git clone https://github.com/dmilad/ocp-viewer-mcp.git
cd ocp-viewer-mcp
# Install with Poetry
poetry install
# Run locally
poetry run python -m ocp_viewer_mcp.serverContributing
Contributions are welcome! Please open an issue first to discuss what you'd like to change.
License
Related Projects
OCP CAD Viewer - The VS Code extension this MCP server integrates with
CadQuery - Python parametric CAD scripting
Build123d - Python CAD scripting with a builder pattern
MCP - Model Context Protocol specification
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Let your AI agent see any public web page: one screenshot tool, returns the page as an image.
CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
Give your agent eyes: screenshots of any web page it can see, pages as markdown, and PDFs.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI tools to capture and process screenshots of a user's screen, allowing AI assistants to see and analyze what the user is looking at through a simple MCP interface.126MIT
- AlicenseAqualityDmaintenanceEnables control of FreeCAD CAD software from Claude Desktop through natural language commands. Supports creating, editing, and managing 3D objects, executing Python code, and generating screenshots of designs.10MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to capture screenshots of web pages using automated browser sessions. Supports full-page and element-specific screenshots, device simulation, and JavaScript execution for comprehensive web testing and monitoring.6MIT
- AlicenseDqualityDmaintenanceEnables AI assistants to capture and analyze screenshots using Claude Vision API, providing AI-powered insights about desktop interface content, UI elements, and visual layouts.2101 npm2MIT