Lumerical MCP Server
Provides tools for photonic simulation workflow automation using Ansys Lumerical products (FDTD, MODE, DEVICE, INTERCONNECT), including session management, geometry creation, material definition, source/monitor configuration, solver setup, result extraction, and optimization.
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.
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_evalandlumerical_callClaude 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.pyManual 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 numpyUsage
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 documentRequirements
Python 3.10+ with
mcpandnumpyAnsys 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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Optical design, simulation and analysis with GPU-powered ray tracing. Import from Zemax and CAD.
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
Build and run agents and automations across hundreds of apps using natural language.
Related MCP Servers
- AlicenseBqualityFmaintenanceEnables natural language-driven ANSYS simulations (Fluent, Mechanical, Geometry) with automatic TUI script generation for reproducibility.415MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to control Ansys Zemax OpticStudio via ZOS-API, allowing optical design tasks like aperture settings, optimization, and analysis through natural language.19-
- AlicenseNot gradedqualityCmaintenanceTurns 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.2MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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.3MIT