Skip to main content
Glama
zxqcreations

Lumerical MCP Server

by zxqcreations
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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: ANSYS 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • ANSYS MCP Server

    Bettertoo2
    A
    license
    B
    quality
    B
    maintenance
    Enables natural language-driven ANSYS simulations (Fluent, Mechanical, Geometry) with automatic TUI script generation for reproducibility.
    41
    6
    MIT

  • hfss-agent-native

    K-13ROBOT
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables natural language control of HFSS (v2019-2025) for antenna modeling, simulation, and result extraction via win32com without PyAEDT.
    5
    MIT

  • zemax-mcp-server

    webworn
    F
    license
    Not graded
    quality
    B
    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.
    10
    -