Lumerical MCP Server

MCP (Model Context Protocol) server for controlling Lumerical FDTD simulations from LLMs.

Installation

cd lumerical-mcp
pip install -e .

Configuration

Required Environment Variable

# Windows (PowerShell)
$env:LUMERICAL_ROOT = "D:\Program Files\ANSYS Inc\v251\Lumerical"

# Windows (cmd)
set LUMERICAL_ROOT=D:\Program Files\ANSYS Inc\v251\Lumerical

# Linux/macOS
export LUMERICAL_ROOT=/opt/lumerical/v251

Optional Environment Variables

Config File (Optional)

Create ~/.config/lumerical-mcp/config.json:

{
  "MCP_HOST": "127.0.0.1",
  "MCP_PORT": 8000,
  "MCP_TRANSPORT": "streamable-http",
  "MCP_WORK_DIR": "C:/Users/name/projects/lumerical",
  "MCP_LOG_LEVEL": "INFO"
}

Environment variables take precedence over config file.

Running the Server

lumerical-mcp

Or with custom settings:

MCP_PORT=9000 MCP_TRANSPORT=stdio lumerical-mcp

Available Tools

Client Usage

# Using the test client
python client_test.py

# Or with custom server address
MCP_HOST=192.168.1.100 MCP_PORT=9000 python client_test.py

LLM Client Configuration

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "lumerical": {
      "command": "lumerical-mcp",
      "env": {
        "LUMERICAL_ROOT": "D:\\Program Files\\ANSYS Inc\\v251\\Lumerical"
      }
    }
  }
}

VS Code / Continue / Other MCP Clients

{
  "mcpServers": {
    "lumerical": {
      "command": "lumerical-mcp",
      "args": [],
      "env": {
        "LUMERICAL_ROOT": "/opt/lumerical/v251"
      }
    }
  }
}

Development

pip install -e .[dev]
ruff check .
pytest

License

MIT