OptiVibe — Claude Code MCP server: features and setup
OptiVibe lets an AI agent work with Zemax OpticStudio designs through MCP. Use it to edit lenses, run analyses, or optimize an optical system from your coding agent.
claude mcp add optivibe-mcp -- uvx optivibe-mcpWhat OptiVibe does
OptiVibe exposes typed tools for loading and changing lens data, running analyses, optimizing designs, and checking tolerances through the ZOS-API. The agent can use these operations without writing raw API calls. A separate reference component provides lookups for operands and glass, plus full-text search across the OpticStudio manual.
You need Windows, Zemax OpticStudio with a ZOS-API license, and Python 3.11+. The project was developed against OpticStudio 2025 R1; other versions have not been tested. Licensing matters at startup: the first engine open checks whether the API license is valid.
The PyPI setup builds reference data from your own OpticStudio installation and checks the install. The optional [manual] extra uses PyMuPDF to read the manual PDF. Run the data builder in a virtual environment or a user-level Python install, since it writes into the installed package directories.
What it helps with
- load an optical design into OpticStudio
- change lens parameters through an agent
- run an analysis or optimize a lens design
- check tolerances for an optical system
- look up OpticStudio operands and glass
Example prompts for the agent
- Load this optical design in OpticStudio and inspect its parameters.
- Optimize this lens design and report the analysis results.
- Search the OpticStudio manual for details about this operand.
How to install OptiVibe
Platform CLI
claude mcp add optivibe-mcp -- uvx optivibe-mcpuvx runs the command named after the package; if the README names another one, use uvx --from optivibe-mcp <command>
Platform CLI
codex mcp add optivibe -- uvx optivibe-mcpuvx runs the command named after the package; if the README names another one, use uvx --from optivibe-mcp <command>
Config file
{
"mcpServers": {
"optivibe": {
"command": "uvx",
"args": [
"optivibe-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from optivibe-mcp <command>
Config file
{
"servers": {
"optivibe": {
"type": "stdio",
"command": "uvx",
"args": [
"optivibe-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from optivibe-mcp <command>
Platform CLI
gemini mcp add optivibe uvx optivibe-mcpuvx runs the command named after the package; if the README names another one, use uvx --from optivibe-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OptiVibe
How do I install OptiVibe in Claude Code?
Run claude mcp add optivibe-mcp -- uvx optivibe-mcp. You also need Windows, Zemax OpticStudio with a ZOS-API license, and Python 3.11+.
What does OptiVibe do?
It connects an agent to Zemax OpticStudio through the ZOS-API. The agent can load and edit designs, run analyses, optimize lenses, and check tolerances.
What does OptiVibe require?
It requires Windows, licensed access to the OpticStudio ZOS-API, and Python 3.11+. Development targeted OpticStudio 2025 R1; other versions have not been tested.
