内容
# PyLumerical MCP 服务器
[](https://docs.pyansys.com/)
[](https://www.python.org/)
[](https://opensource.org/licenses/Apache-2.0)
PyLumerical MCP 服务器提供一个[模型上下文协议(MCP)](https://modelcontextprotocol.io/)
服务器,使 AI 助手能够通过
[PyLumerical](https://github.com/ansys/pylumerical)与 Ansys Lumerical(FDTD, MODE,
DEVICE, INTERCONNECT)交互。该服务器使自然语言交互 Lumerical 用于光子学和电磁仿真工作流成为可能。
## 概述
主要功能:
- **多会话管理**:打开、列出和关闭多个并发
Lumerical 会话(FDTD, MODE, DEVICE, INTERCONNECT),会话名称由用户选择。
- **持久 Python 执行**:在活跃的 Lumerical 句柄上运行任意 Python 和 PyLumerical 代码,
并在工具调用之间保存状态。
- **工作流程指导**:访问 Lumerical 仿真的上下文和最佳实践。
- **跨平台支持**:通过无头 CAD 实现 Windows 和 Linux 支持。
## 先决条件
- Python 3.11, 3.12, 3.13 或 3.14
- Ansys Lumerical 安装
- Ansys Lumerical 许可证
## 安装
### 对于用户
使用以下命令安装最新版本:
```bash
pip install ansys-lumerical-mcp
```
或使用 [`uvx`](https://docs.astral.sh/uv/) 直接运行而无需安装:
```bash
uvx --from git+https://github.com/ansys/pylumerical-mcp ansys-lumerical-mcp
```
### 对于开发者
#### 安装
```bash
# 克隆仓库
git clone https://github.com/ansys/pylumerical-mcp.git
cd pylumerical-mcp
# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate # 在 Windows 上:.venv\Scripts\activate 或 .venv\Scripts\Activate.ps1
pip install uv
# 安装依赖
uv sync
# 运行
uv run ansys-lumerical-mcp
```
#### 使用 VS Code 或 Cursor 快速启动
如果您正在使用开发容器:
```jsonc
{
"servers": {
"pylumerical-mcp": {
"type": "stdio",
"command": "/workspaces/pylumerical-mcp/.venv/bin/ansys-lumerical-mcp",
"args": []
}
},
"inputs": []
}
```
## 使用
有关 VS Code、Claude Code、Claude Desktop、
Cursor 和其他 MCP 兼容客户端的逐步设置说明,请参阅客户端文档。
## 许可证
该项目在 Apache 2.0 许可证协议下获得许可。有关详细信息,请参阅 [LICENSE](./LICENSE) 文件。
## 资源
- [PyLumerical-MCP 文档](https://lumerical-mcp.docs.pyansys.com)
- [PyLumerical 文档](https://github.com/ansys/pylumerical)
- [模型上下文协议](https://modelcontextprotocol.io/)
- [FastMCP 文档](https://github.com/jlowin/fastmcp)
- [Ansys Lumerical](https://www.ansys.com/products/photonics)
- [存储库问题页面](https://github.com/ansys/pylumerical-mcp/issues)
- [存储库讨论页面](https://github.com/ansys/pylumerical-mcp/discussions)
有关 PyAnsys 的一般问题,请发送电子邮件至 [pyansys.core@ansys.com](mailto:pyansys.core@ansys.com)。