gitwtfhub

wtf is optivibe-mcp?

chuang44-tiff/optivibe-mcp — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 4/5LicenseSetup · hard

TL;DR

An experimental MCP server that lets a coding agent like Claude Code control Zemax OpticStudio, professional lens and optical design software, through typed tools.

Mindmap

mindmap
  root((repo))
    What it does
      Drive OpticStudio via MCP
      80 plus typed tools
      Reference lookups
    Tech stack
      Python
      .NET Framework
      ZOS-API
      MCP
    Use cases
      Automated lens design edits
      Optimization and tolerancing
      Manual and glass search
    Audience
      Optical engineers
      Claude Code users
      Developers
    Setup
      Windows only
      Licensed OpticStudio
      Build reference data

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Let a coding agent like Claude Code drive Zemax OpticStudio to load, edit, and analyze lens designs.

REASON 2

Run automated optimization and tolerancing on optical designs from within an agent workflow.

REASON 3

Search the OpticStudio manual and glass catalog for grounding before making design changes.

What's in the stack?

Python.NET FrameworkMCPZOS-API

How it stacks up

chuang44-tiff/optivibe-mcp0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity4/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires Windows, a licensed Zemax OpticStudio install, and building local reference data before use.

Apache License 2.0: free to use, modify, and distribute, including commercially, as long as you preserve copyright and license notices.

Wtf does this do

Optivibe-mcp is an experimental MCP server that lets a coding agent, like Claude Code, control Zemax OpticStudio, which is professional software used to design optical systems such as lenses and camera systems. Instead of the agent writing raw code to talk to OpticStudio's API, this project wraps that interface in more than 80 typed tools covering loading designs, editing lens data, running analyses, optimizing designs, and tolerancing. Alongside those control tools, the project includes a separate reference layer the agent can query for grounding: lookups for optical operands and glass types, plus full text search over the OpticStudio manual. Every tool returns a consistent result object rather than throwing an error, so the agent is expected to check the returned value to confirm a call actually worked rather than assuming success just because nothing failed. This project ships as code only. It does not include any of Zemax's proprietary data, such as the glass catalog or manual text. Users generate that data themselves from their own licensed OpticStudio installation using build scripts included in the repository. Using this requires a fairly specific setup: Windows, since OpticStudio and its API are Windows-only, a licensed copy of OpticStudio (developed and tested against the 2025 R1 release), Python 3.11 or newer, and the .NET Framework, which the project configures automatically. After installing the two Python packages and building the local reference data, a user registers the server with Claude Code by pointing it at the right Python interpreter. The project also bundles a handful of Claude Code skills for tasks like reviewing a design against a specification, comparing two designs, running an optimization loop with monitoring, and troubleshooting connection or license errors. The author describes the project as experimental, tested against only one version of OpticStudio on Windows, with interfaces that may still change. It is licensed under Apache License 2.0 and is not affiliated with or endorsed by Ansys or Zemax.

Yoink these prompts

Prompt 1
Help me install optivibe-reference and optivibe-harness and register this MCP server with Claude Code.
Prompt 2
Walk me through building the local reference data from my licensed OpticStudio install.
Prompt 3
Show me how to use the design-review skill to check a lens design against a spec.
Prompt 4
Explain how the tool result envelope works so I can verify a ZOS-API call actually succeeded.

Frequently asked questions

wtf is optivibe-mcp?

An experimental MCP server that lets a coding agent like Claude Code control Zemax OpticStudio, professional lens and optical design software, through typed tools.

What language is optivibe-mcp written in?

Mainly Python. The stack also includes Python, .NET Framework, MCP.

What license does optivibe-mcp use?

Apache License 2.0: free to use, modify, and distribute, including commercially, as long as you preserve copyright and license notices.

How hard is optivibe-mcp to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is optivibe-mcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.