Skip to main content
Glama

Lumerical MCP Server & Skill

Complete MCP (Model Context Protocol) server and Claude Code Skill for Ansys Lumerical photonic simulation tools — FDTD, MODE, DEVICE, and INTERCONNECT.

What This Provides

  • MCP Server with 40+ structured tools covering the full Lumerical workflow

  • 480+ script commands accessible via lumerical_eval and lumerical_call

  • Claude Code Skill for natural-language-driven simulation automation

  • Documentation search across all Lumerical scripting commands

Related MCP server: zemax-mcp-server

Capabilities

Domain

Coverage

Session Management

Open/close/list sessions for FDTD, MODE, DEVICE, INTERCONNECT

Script Execution

Execute arbitrary LSF, get/set variables, call any command

Simulation Control

Run, load, save, reset, layout mode

Geometry

Add rect/sphere/circle/polygon/waveguide + select/copy/move/rotate/delete

Materials

Add/modify/get materials, import nk data, query refractive index, thin-film T/R

Sources

Dipole, mode, gaussian, plane wave, TFSF, imported

Monitors

Power, profile, index, time, movie, field, absorption, mode expansion, bandstructure

Solvers

FDTD, FDE, EME, varFDTD, DGTD, Charge, Heat, FEEM

Boundaries

PML, Periodic, PEC, PMC, Absorbing

Results

Get result/data, field extraction, far-field projection, transmission spectra, CSV export

Optimization

Parameter sweeps, adjoint inverse design, parallel job execution

Documentation

List/search/help for 480+ commands, categorized browsing, example discovery

Quick Install

cd D:\ENV\claude\Lumerical_MCP

# Check your Lumerical installation
python install.py --check

# Install both MCP server config and Skill
python install.py

Manual MCP Configuration

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "lumerical": {
      "command": "python",
      "args": ["-m", "mcp_server.server"],
      "cwd": "D:\\ENV\\claude\\Lumerical_MCP",
      "description": "Lumerical MCP - FDTD, MODE, DEVICE, INTERCONNECT"
    }
  }
}

Environment Setup

# Required: Point to your Lumerical installation
set LUMERICAL_HOME=D:\ENV\Lumerical\v202

# Install Python dependencies
pip install mcp numpy

Usage

In Claude Code, type /lumerical to invoke the Skill, or use MCP tools directly:

lumerical_open("fdtd")  →  {"session_id": "lum_1", "product": "fdtd"}
lumerical_eval("lum_1", "addfdtd;\nset('dimension',2);\nset('x span',2e-6);\nrun;")
lumerical_close("lum_1")

Project Structure

Lumerical_MCP/
├── mcp_server/
│   ├── server.py              # Main MCP server entry point (FastMCP)
│   ├── session_manager.py     # Session lifecycle (open/close/eval/var)
│   ├── command_docs.py        # Load & query 480+ command docs
│   └── tools/
│       ├── session.py         # Session management (5 tools)
│       ├── script.py          # Script execution (4 tools)
│       ├── simulation.py      # Simulation lifecycle (6 tools)
│       ├── geometry.py        # Geometry & objects (10 tools)
│       ├── material.py        # Materials (6 tools)
│       ├── source_monitor.py  # Sources & monitors (4 tools)
│       ├── solver.py          # Solver config (4 tools)
│       ├── results.py         # Results & analysis (6 tools)
│       ├── optimization.py    # Sweeps & optimization (6 tools)
│       └── docs.py            # Documentation & discovery (7 tools)
├── skill/
│   └── lumerical.md           # Claude Code Skill definition
├── lumerical-docs/            # Local documentation repository (727 cmd docs)
├── install.py                 # One-step installer
├── pyproject.toml
├── README.md
└── DESIGN.md                  # Architecture design document

Requirements

  • Python 3.10+ with mcp and numpy

  • Ansys Lumerical v202 (or later) installed locally

  • Lumerical GUI license

  • Windows (primary; Linux/macOS supported via lumapi)

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      F
      maintenance
      Enables natural language-driven ANSYS simulations (Fluent, Mechanical, Geometry) with automatic TUI script generation for reproducibility.
      41
      5
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to control Ansys Zemax OpticStudio via ZOS-API, allowing optical design tasks like aperture settings, optimization, and analysis through natural language.
      19
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Turns CST Studio Suite into an AI-controllable electromagnetic design lab, enabling conversational THz metamaterial absorber design, unit-cell automation, Floquet port control, batch solve with checkpoint-resume, and surrogate-model predictions.
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables natural-language-driven modeling, simulation, and optimization of antennas in CST Studio Suite, covering geometry, materials, ports, solvers, S-parameters, far-field analysis, parameter sweeps, and optimization via 73 MCP tools.
      3
      MIT