lumerical-mcp 0.1.0__tar.gz

lumerical_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: lumerical-mcp
+Version: 0.1.0
+Summary: MCP server for Lumerical FDTD automation
+Author-email: Saku1234 <lxh875410020@gmail.com>
+Maintainer-email: Saku1234 <lxh875410020@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/saku123hh/lumerical-mcp
+Project-URL: Repository, https://github.com/saku123hh/lumerical-mcp
+Project-URL: Issues, https://github.com/saku123hh/lumerical-mcp/issues
+Keywords: mcp,lumerical,fdtd,photonics,simulation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: numpy
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# Lumerical MCP Server
+
+MCP (Model Context Protocol) server for controlling Lumerical FDTD simulations from LLMs.
+
+## Installation
+
+```bash
+cd lumerical-mcp
+pip install -e .
+```
+
+## Configuration
+
+### Required Environment Variable
+
+```bash
+# 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
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MCP_HOST` | `127.0.0.1` | Server bind address |
+| `MCP_PORT` | `8000` | Server port |
+| `MCP_TRANSPORT` | `streamable-http` | Transport protocol (`streamable-http` or `stdio`) |
+| `MCP_WORK_DIR` | Current directory | Working directory for relative paths |
+| `MCP_LOG_LEVEL` | `INFO` | Log level (`DEBUG`, `INFO`, `WARNING`, `ERROR`) |
+
+### Config File (Optional)
+
+Create `~/.config/lumerical-mcp/config.json`:
+
+```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
+
+```bash
+lumerical-mcp
+```
+
+Or with custom settings:
+
+```bash
+MCP_PORT=9000 MCP_TRANSPORT=stdio lumerical-mcp
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `hello` | Connectivity check |
+| `start_fdtd` / `end_fdtd` | Start/stop FDTD API session |
+| `open_projects` / `fdtd_load_project_tool` | Load `.fsp` project |
+| `save_project` / `fdtd_save_project_tool` | Save project |
+| `set_parameter` | Set object property |
+| `run_simulation` / `fdtd_run_simulation_tool` | Run simulation |
+| `get_transmission` | Get transmission spectrum from monitor |
+| `fdtd_eval_script_tool` | Execute Lumerical script |
+| `fdtd_eval_script_get_tool` | Execute script and return variable |
+| `fdtd_run_script_file_tool` | Run `.lsf`/`.lsfx` script file |
+| `fdtd_get_variable_tool` / `fdtd_put_variable_tool` | Read/write script variables |
+| `fdtd_launch_gui_tool` | Launch Lumerical GUI |
+| `fdtd_command_docs_tool` | Search command documentation |
+
+## Client Usage
+
+```bash
+# 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`)
+
+```json
+{
+  "mcpServers": {
+    "lumerical": {
+      "command": "lumerical-mcp",
+      "env": {
+        "LUMERICAL_ROOT": "D:\\Program Files\\ANSYS Inc\\v251\\Lumerical"
+      }
+    }
+  }
+}
+```
+
+### VS Code / Continue / Other MCP Clients
+
+```json
+{
+  "mcpServers": {
+    "lumerical": {
+      "command": "lumerical-mcp",
+      "args": [],
+      "env": {
+        "LUMERICAL_ROOT": "/opt/lumerical/v251"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+pip install -e .[dev]
+ruff check .
+pytest
+```
+
+## License
+
+MIT

lumerical_mcp-0.1.0/README.md

@@ -0,0 +1,136 @@
+# Lumerical MCP Server
+
+MCP (Model Context Protocol) server for controlling Lumerical FDTD simulations from LLMs.
+
+## Installation
+
+```bash
+cd lumerical-mcp
+pip install -e .
+```
+
+## Configuration
+
+### Required Environment Variable
+
+```bash
+# 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
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MCP_HOST` | `127.0.0.1` | Server bind address |
+| `MCP_PORT` | `8000` | Server port |
+| `MCP_TRANSPORT` | `streamable-http` | Transport protocol (`streamable-http` or `stdio`) |
+| `MCP_WORK_DIR` | Current directory | Working directory for relative paths |
+| `MCP_LOG_LEVEL` | `INFO` | Log level (`DEBUG`, `INFO`, `WARNING`, `ERROR`) |
+
+### Config File (Optional)
+
+Create `~/.config/lumerical-mcp/config.json`:
+
+```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
+
+```bash
+lumerical-mcp
+```
+
+Or with custom settings:
+
+```bash
+MCP_PORT=9000 MCP_TRANSPORT=stdio lumerical-mcp
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `hello` | Connectivity check |
+| `start_fdtd` / `end_fdtd` | Start/stop FDTD API session |
+| `open_projects` / `fdtd_load_project_tool` | Load `.fsp` project |
+| `save_project` / `fdtd_save_project_tool` | Save project |
+| `set_parameter` | Set object property |
+| `run_simulation` / `fdtd_run_simulation_tool` | Run simulation |
+| `get_transmission` | Get transmission spectrum from monitor |
+| `fdtd_eval_script_tool` | Execute Lumerical script |
+| `fdtd_eval_script_get_tool` | Execute script and return variable |
+| `fdtd_run_script_file_tool` | Run `.lsf`/`.lsfx` script file |
+| `fdtd_get_variable_tool` / `fdtd_put_variable_tool` | Read/write script variables |
+| `fdtd_launch_gui_tool` | Launch Lumerical GUI |
+| `fdtd_command_docs_tool` | Search command documentation |
+
+## Client Usage
+
+```bash
+# 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`)
+
+```json
+{
+  "mcpServers": {
+    "lumerical": {
+      "command": "lumerical-mcp",
+      "env": {
+        "LUMERICAL_ROOT": "D:\\Program Files\\ANSYS Inc\\v251\\Lumerical"
+      }
+    }
+  }
+}
+```
+
+### VS Code / Continue / Other MCP Clients
+
+```json
+{
+  "mcpServers": {
+    "lumerical": {
+      "command": "lumerical-mcp",
+      "args": [],
+      "env": {
+        "LUMERICAL_ROOT": "/opt/lumerical/v251"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+pip install -e .[dev]
+ruff check .
+pytest
+```
+
+## License
+
+MIT

lumerical_mcp-0.1.0/lumerical_mcp/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

lumerical_mcp-0.1.0/lumerical_mcp/config.py

@@ -0,0 +1,56 @@
+import os
+import json
+from pathlib import Path
+from dataclasses import dataclass, field
+
+
+@dataclass
+class Config:
+    lumerical_root: Path
+    host: str = "127.0.0.1"
+    port: int = 8000
+    transport: str = "streamable-http"
+    work_dir: Path = field(default_factory=Path.cwd)
+    log_level: str = "INFO"
+
+    @property
+    def lumerical_api_python(self) -> Path:
+        return self.lumerical_root / "api" / "python"
+
+    @property
+    def lumerical_bin(self) -> Path:
+        return self.lumerical_root / "bin"
+
+    @classmethod
+    def load(cls) -> "Config":
+        lumerical_root = os.environ.get("LUMERICAL_ROOT")
+        if not lumerical_root:
+            raise RuntimeError(
+                "LUMERICAL_ROOT environment variable not set. "
+                "Point it to your Lumerical installation directory, e.g.: "
+                "  Windows: D:\\Program Files\\ANSYS Inc\\v251\\Lumerical "
+                "  Linux: /opt/lumerical/v251"
+            )
+        root = Path(lumerical_root).expanduser().resolve()
+        if not root.exists():
+            raise RuntimeError(f"LUMERICAL_ROOT path does not exist: {root}")
+
+        config_file = Path.home() / ".config" / "lumerical-mcp" / "config.json"
+        file_cfg = {}
+        if config_file.exists():
+            try:
+                file_cfg = json.loads(config_file.read_text(encoding="utf-8"))
+            except Exception:
+                pass
+
+        def get(key: str, default):
+            return os.environ.get(key) or file_cfg.get(key) or default
+
+        return cls(
+            lumerical_root=root,
+            host=get("MCP_HOST", "127.0.0.1"),
+            port=int(get("MCP_PORT", "8000")),
+            transport=get("MCP_TRANSPORT", "streamable-http"),
+            work_dir=Path(get("MCP_WORK_DIR", str(Path.cwd()))).expanduser().resolve(),
+            log_level=get("MCP_LOG_LEVEL", "INFO"),
+        )

lumerical_mcp-0.1.0/lumerical_mcp/server.py

@@ -0,0 +1,311 @@
+import os
+import sys
+import time
+import json
+import subprocess
+import logging
+from pathlib import Path
+from typing import Any, Optional
+
+from .config import Config
+
+cfg = Config.load()
+
+logging.basicConfig(level=cfg.log_level, format="%(asctime)s %(levelname)s %(name)s: %(message)s")
+logger = logging.getLogger("lumerical-mcp")
+
+for _directory in (cfg.lumerical_api_python, cfg.lumerical_bin):
+    _directory_str = str(_directory)
+    if _directory.exists():
+        if _directory_str not in sys.path:
+            sys.path.append(_directory_str)
+        if hasattr(os, "add_dll_directory"):
+            try:
+                os.add_dll_directory(_directory_str)
+            except OSError:
+                pass
+
+import lumapi
+
+from mcp.server.mcpserver import MCPServer
+
+mcp = MCPServer("lumerical")
+
+fdtd = None
+_gui_jobs: dict[str, dict[str, Any]] = {}
+
+
+def _ensure_fdtd(hide: bool = False):
+    global fdtd
+    if fdtd is None:
+        fdtd = lumapi.FDTD(hide=hide)
+    return fdtd
+
+
+def _jsonable(value: Any, max_array_items: int = 2000) -> Any:
+    try:
+        import numpy as np
+    except Exception:
+        np = None
+
+    if value is None or isinstance(value, (bool, int, float, str)):
+        return value
+
+    if isinstance(value, bytes):
+        return value.decode("utf-8", errors="replace")
+
+    if isinstance(value, complex):
+        return {"real": value.real, "imag": value.imag}
+
+    if np is not None:
+        if isinstance(value, np.generic):
+            return _jsonable(value.item(), max_array_items)
+        if isinstance(value, np.ndarray):
+            size = int(value.size)
+            if size <= max_array_items:
+                return {
+                    "type": "ndarray",
+                    "shape": list(value.shape),
+                    "dtype": str(value.dtype),
+                    "data": _jsonable(value.tolist(), max_array_items),
+                }
+            flat = value.ravel()
+            return {
+                "type": "ndarray",
+                "shape": list(value.shape),
+                "dtype": str(value.dtype),
+                "size": size,
+                "sample": _jsonable(flat[:20].tolist(), max_array_items),
+                "truncated": True,
+            }
+
+    if isinstance(value, dict):
+        return {str(k): _jsonable(v, max_array_items) for k, v in value.items()}
+
+    if isinstance(value, (list, tuple)):
+        return [_jsonable(item, max_array_items) for item in value]
+
+    return repr(value)
+
+
+@mcp.tool()
+def hello(name: str) -> str:
+    return f"Hello {name}, MCP is working."
+
+
+@mcp.tool()
+def start_fdtd() -> str:
+    global fdtd
+    if fdtd is not None:
+        return "FDTD is already running."
+    fdtd = lumapi.FDTD()
+    return "Lumerical FDTD started successfully."
+
+
+@mcp.tool()
+def end_fdtd() -> str:
+    global fdtd
+    if fdtd is None:
+        return "No FDTD session is running."
+    fdtd.close()
+    fdtd = None
+    return "Lumerical FDTD closed."
+
+
+@mcp.tool()
+def open_projects(path: str) -> str:
+    session = _ensure_fdtd()
+    session.load(str(cfg.work_dir / path) if not Path(path).is_absolute() else path)
+    return f"Project opened: {path}"
+
+
+@mcp.tool()
+def set_parameter(object_name: str, property_name: str, value: float) -> str:
+    if fdtd is None:
+        return "FDTD is not running."
+    fdtd.switchtolayout()
+    fdtd.setnamed(object_name, property_name, value)
+    return f"{object_name}: {property_name} = {value}"
+
+
+@mcp.tool()
+def run_simulation() -> str:
+    if fdtd is None:
+        return "FDTD is not running."
+    fdtd.run()
+    return "Simulation finished."
+
+
+@mcp.tool()
+def save_project(path: str) -> str:
+    if fdtd is None:
+        return "FDTD is not running."
+    fdtd.save(str(cfg.work_dir / path) if not Path(path).is_absolute() else path)
+    return f"Project saved: {path}"
+
+
+@mcp.tool()
+def get_transmission(monitor_name: str) -> dict:
+    if fdtd is None:
+        return {"error": "FDTD is not running."}
+    result = fdtd.getresult(monitor_name, "T")
+    wavelength = result["lambda"].flatten().flip()
+    transmission = result["T"].flatten().flip()
+    return {
+        "wavelength_nm": (wavelength * 1e9).tolist(),
+        "T": transmission.tolist(),
+    }
+
+
+@mcp.tool()
+def fdtd_eval_script_tool(code: str) -> dict:
+    session = _ensure_fdtd()
+    session.eval(code)
+    return {"ok": True, "executed": True}
+
+
+@mcp.tool()
+def fdtd_eval_script_get_tool(code: str, return_var: str, max_array_items: int = 2000) -> dict:
+    session = _ensure_fdtd()
+    session.eval(code)
+    value = session.getv(return_var)
+    return {
+        "ok": True,
+        "variable": return_var,
+        "value": _jsonable(value, max_array_items),
+    }
+
+
+@mcp.tool()
+def fdtd_run_script_file_tool(script_path: str) -> dict:
+    session = _ensure_fdtd()
+    path = str(cfg.work_dir / script_path) if not Path(script_path).is_absolute() else script_path
+    if path.lower().endswith(".lsfx"):
+        session.eval(path[:-5] + ";")
+    else:
+        session.feval(path)
+    return {"ok": True, "script_path": path}
+
+
+@mcp.tool()
+def fdtd_get_variable_tool(name: str, max_array_items: int = 2000) -> dict:
+    session = _ensure_fdtd()
+    value = session.getv(name)
+    return {
+        "ok": True,
+        "variable": name,
+        "value": _jsonable(value, max_array_items),
+    }
+
+
+@mcp.tool()
+def fdtd_put_variable_tool(name: str, value: Any) -> dict:
+    session = _ensure_fdtd()
+    session.putv(name, value)
+    return {"ok": True, "variable": name}
+
+
+@mcp.tool()
+def fdtd_load_project_tool(project_path: str) -> dict:
+    session = _ensure_fdtd()
+    path = str(cfg.work_dir / project_path) if not Path(project_path).is_absolute() else project_path
+    session.load(path)
+    return {"ok": True, "project_path": path}
+
+
+@mcp.tool()
+def fdtd_save_project_tool(project_path: Optional[str] = None) -> dict:
+    session = _ensure_fdtd()
+    if project_path:
+        path = str(cfg.work_dir / project_path) if not Path(project_path).is_absolute() else project_path
+        session.save(path)
+    else:
+        session.save()
+        path = None
+    return {"ok": True, "project_path": path}
+
+
+@mcp.tool()
+def fdtd_run_simulation_tool() -> dict:
+    session = _ensure_fdtd()
+    started_at = time.time()
+    session.eval("run;")
+    return {"ok": True, "elapsed_seconds": time.time() - started_at}
+
+
+@mcp.tool()
+def fdtd_launch_gui_tool(target: str = "launcher", project_path: Optional[str] = None) -> dict:
+    if target.lower() in {"fdtd", "fdtd-solutions", "solutions"}:
+        exe = cfg.lumerical_bin / "fdtd-solutions.exe"
+    else:
+        exe = cfg.lumerical_bin / "launcher.exe"
+
+    if not exe.exists():
+        return {"ok": False, "error": f"Executable not found: {exe}"}
+
+    args = [str(exe)]
+    if project_path:
+        path = str(cfg.work_dir / project_path) if not Path(project_path).is_absolute() else project_path
+        args.append(path)
+
+    try:
+        process = subprocess.Popen(
+            args,
+            cwd=str(cfg.lumerical_bin) if cfg.lumerical_bin.exists() else None,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+            stdin=subprocess.DEVNULL,
+        )
+    except OSError as exc:
+        return {"ok": False, "error": f"{type(exc).__name__}: {exc}"}
+
+    job_id = f"fdtd-gui-{int(time.time())}-{process.pid}"
+    _gui_jobs[job_id] = {
+        "job_id": job_id,
+        "pid": process.pid,
+        "target": target,
+        "args": args,
+        "started_at": time.time(),
+    }
+    return {"ok": True, **_gui_jobs[job_id]}
+
+
+@mcp.tool()
+def fdtd_command_docs_tool(query: str = "", limit: int = 50) -> dict:
+    docs_path = cfg.lumerical_api_python / "docs.json"
+    if not docs_path.exists():
+        return {"ok": False, "error": f"docs.json not found: {docs_path}"}
+
+    docs = json.loads(docs_path.read_text(encoding="utf-8", errors="replace"))
+    needle = query.lower() if query else None
+    items = []
+
+    for name, entry in docs.items():
+        if isinstance(entry, dict):
+            text = entry.get("text", "")
+            link = entry.get("link", "")
+        else:
+            text = str(entry)
+            link = ""
+
+        if needle:
+            haystack = f"{name}\n{text}".lower()
+            if needle not in haystack:
+                continue
+
+        items.append({"name": name, "text": text, "link": link})
+        if len(items) >= limit:
+            break
+
+    return {"ok": True, "count": len(items), "commands": items}
+
+
+def main():
+    logger.info(f"Starting Lumerical MCP server on {cfg.host}:{cfg.port} ({cfg.transport})")
+    logger.info(f"Lumerical root: {cfg.lumerical_root}")
+    logger.info(f"Work directory: {cfg.work_dir}")
+    mcp.run(transport=cfg.transport, host=cfg.host, port=cfg.port)
+
+
+if __name__ == "__main__":
+    main()

lumerical_mcp-0.1.0/lumerical_mcp.egg-info/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: lumerical-mcp
+Version: 0.1.0
+Summary: MCP server for Lumerical FDTD automation
+Author-email: Saku1234 <lxh875410020@gmail.com>
+Maintainer-email: Saku1234 <lxh875410020@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/saku123hh/lumerical-mcp
+Project-URL: Repository, https://github.com/saku123hh/lumerical-mcp
+Project-URL: Issues, https://github.com/saku123hh/lumerical-mcp/issues
+Keywords: mcp,lumerical,fdtd,photonics,simulation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: numpy
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# Lumerical MCP Server
+
+MCP (Model Context Protocol) server for controlling Lumerical FDTD simulations from LLMs.
+
+## Installation
+
+```bash
+cd lumerical-mcp
+pip install -e .
+```
+
+## Configuration
+
+### Required Environment Variable
+
+```bash
+# 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
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MCP_HOST` | `127.0.0.1` | Server bind address |
+| `MCP_PORT` | `8000` | Server port |
+| `MCP_TRANSPORT` | `streamable-http` | Transport protocol (`streamable-http` or `stdio`) |
+| `MCP_WORK_DIR` | Current directory | Working directory for relative paths |
+| `MCP_LOG_LEVEL` | `INFO` | Log level (`DEBUG`, `INFO`, `WARNING`, `ERROR`) |
+
+### Config File (Optional)
+
+Create `~/.config/lumerical-mcp/config.json`:
+
+```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
+
+```bash
+lumerical-mcp
+```
+
+Or with custom settings:
+
+```bash
+MCP_PORT=9000 MCP_TRANSPORT=stdio lumerical-mcp
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `hello` | Connectivity check |
+| `start_fdtd` / `end_fdtd` | Start/stop FDTD API session |
+| `open_projects` / `fdtd_load_project_tool` | Load `.fsp` project |
+| `save_project` / `fdtd_save_project_tool` | Save project |
+| `set_parameter` | Set object property |
+| `run_simulation` / `fdtd_run_simulation_tool` | Run simulation |
+| `get_transmission` | Get transmission spectrum from monitor |
+| `fdtd_eval_script_tool` | Execute Lumerical script |
+| `fdtd_eval_script_get_tool` | Execute script and return variable |
+| `fdtd_run_script_file_tool` | Run `.lsf`/`.lsfx` script file |
+| `fdtd_get_variable_tool` / `fdtd_put_variable_tool` | Read/write script variables |
+| `fdtd_launch_gui_tool` | Launch Lumerical GUI |
+| `fdtd_command_docs_tool` | Search command documentation |
+
+## Client Usage
+
+```bash
+# 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`)
+
+```json
+{
+  "mcpServers": {
+    "lumerical": {
+      "command": "lumerical-mcp",
+      "env": {
+        "LUMERICAL_ROOT": "D:\\Program Files\\ANSYS Inc\\v251\\Lumerical"
+      }
+    }
+  }
+}
+```
+
+### VS Code / Continue / Other MCP Clients
+
+```json
+{
+  "mcpServers": {
+    "lumerical": {
+      "command": "lumerical-mcp",
+      "args": [],
+      "env": {
+        "LUMERICAL_ROOT": "/opt/lumerical/v251"
+      }
+    }
+  }
+}
+```
+
+## Development
+
+```bash
+pip install -e .[dev]
+ruff check .
+pytest
+```
+
+## License
+
+MIT

lumerical_mcp-0.1.0/lumerical_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+lumerical_mcp/__init__.py
+lumerical_mcp/config.py
+lumerical_mcp/server.py
+lumerical_mcp.egg-info/PKG-INFO
+lumerical_mcp.egg-info/SOURCES.txt
+lumerical_mcp.egg-info/dependency_links.txt
+lumerical_mcp.egg-info/entry_points.txt
+lumerical_mcp.egg-info/requires.txt
+lumerical_mcp.egg-info/top_level.txt

lumerical_mcp-0.1.0/lumerical_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

lumerical_mcp-0.1.0/lumerical_mcp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+lumerical-mcp = lumerical_mcp.server:main

lumerical_mcp-0.1.0/lumerical_mcp.egg-info/requires.txt

@@ -0,0 +1,6 @@
+mcp>=1.0.0
+numpy
+
+[dev]
+pytest
+ruff

lumerical_mcp-0.1.0/lumerical_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+lumerical_mcp

lumerical_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+# D:\Files\gitProjects\lumerical-mcp\pyproject.toml
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lumerical-mcp"
+version = "0.1.0"
+description = "MCP server for Lumerical FDTD automation"
+readme = "README.md"
+license = "MIT"
+authors = [{name = "Saku1234", email = "lxh875410020@gmail.com"}]
+maintainers = [{name = "Saku1234", email = "lxh875410020@gmail.com"}]
+keywords = ["mcp", "lumerical", "fdtd", "photonics", "simulation"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Physics",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "mcp>=1.0.0",
+    "numpy",
+]
+
+[project.urls]
+Homepage = "https://github.com/saku123hh/lumerical-mcp"
+Repository = "https://github.com/saku123hh/lumerical-mcp"
+Issues = "https://github.com/saku123hh/lumerical-mcp/issues"
+
+[project.optional-dependencies]
+dev = ["pytest", "ruff"]
+
+[project.scripts]
+"lumerical-mcp" = "lumerical_mcp.server:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["lumerical_mcp*"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"

lumerical_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+