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.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Lumerical MCP Serveradd a waveguide and run a mode simulation"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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: ansys-aedt-mcp
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
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityBmaintenanceKnowledge-based MCP server for photonics simulation engineering, providing rules, bugs, checklists, and tool recommendations for Lumerical FDTD/MODE/FDE, HFSS, COMSOL, and PyAEDT.Last updatedMIT
- AlicenseCqualityBmaintenanceEnables AI agents to control Ansys Electronics Desktop (HFSS, Maxwell, Q3D, etc.) using MCP tools for simulation automation.Last updated10029PolyForm Noncommercial 1.0.0
- Alicense-qualityCmaintenanceEnables natural language-driven ANSYS simulations (Fluent, Mechanical, Geometry) with automatic TUI script generation for reproducibility.Last updated5MIT
- Alicense-qualityBmaintenanceEnables natural language control of HFSS (v2019-2025) for antenna modeling, simulation, and result extraction via win32com without PyAEDT.Last updated1MIT
Related MCP Connectors
Create and manage AI agents that collaborate and solve problems through natural language interacti…
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
AI-callable calculators and engineering models with real formulas. No hallucinated math.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/zxqcreations/Lumerical_MCP_Skill'
If you have feedback or need assistance with the MCP directory API, please join our Discord server