Sentaurus MCP｜让 LLM 访问 Sentaurus

Name: sentaurus-mcp
Author: HanKin666

本版本为 v0.1.0-alpha.3，Python 包版本为 0.1.0a3。这是预发布测试版，新增原生工程只读索引、按字段名读取 ASCII PLT、图像来源记录，以及状态证据、失败诊断和 ZIP 导出。详见alpha.3 候选说明、原生证据接口和状态与实验打包。

这是什么

Sentaurus MCP 让 AI 助手通过工具读取实验记录和日志，并提交 Sentaurus 仿真脚本。 你用自然语言提出任务，助手调用 MCP；真正计算的是 Sentaurus。

Sentaurus 通常装在服务器上，AI 助手通常在你的电脑上。因此需要先登录服务器，再配置服务器上的 Sentaurus 运行环境。

名称	在这里负责什么	在哪里运行
AI 助手／LLM 客户端	理解你的要求，调用工具，解释返回的结果	通常在你的电脑上
SSH	让本机客户端在服务器上启动 MCP 并交换信息	连接你的电脑和服务器
MCP 接口	接收助手的请求，保存实验、查询状态和读取日志	Sentaurus 所在服务器
后台执行器（Worker）	从队列取出实验，启动 Sentaurus，记录运行状态	同一服务器，单独启动并保持运行
Sentaurus	执行结构、网格和器件仿真	服务器
VNC Viewer	显示服务器桌面，方便查看 Sentaurus 原生界面	你的电脑；当前 MCP 不通过它控制软件

当前文档描述 v0.1.0-alpha.3。较早的 alpha.2 不包含这次新增功能。验证范围和限制见验证记录。

快速开始

只知道服务器端口号和密码？先把这段话发给 LLM

复制下面的指令，发给能访问本机文件、运行命令并配置 MCP 的 AI 助手。普通网页聊天窗口如果没有这些权限，只能指导你操作，不能代你安装。

请帮我安装并连接这个 Sentaurus MCP：
https://github.com/HanKin666/sentaurus-mcp

我是新手，目前只知道服务器端口号和密码，不确定是 VNC 还是 SSH。
请使用仓库 main 分支的最新说明和连接向导，先检查本机是否已安装。
一次只问我当前缺少的必要信息，不要让我先理解全部技术配置。

先问我服务器地址，以及平时用什么软件连接。
如果我只知道端口，不要把它当作服务器地址，也不要猜测 SSH 端口。
密码请让我在本地隐藏输入，不要让我发到对话里。

如果可以读取已有连接配置，请先让我指定具体文件或连接条目；
仅提取服务器地址、端口和用户名，不读取密码或私钥内容。
识别连接方式后，告诉我：
本机安装、服务器连接、后台执行器、Sentaurus 验证分别到了哪一步。
只保存配置或看到远程桌面时，不要说仿真已经可用。
在真正提交仿真前，先说明准备运行的实验和需要的资源。

助手能否替你安装，取决于它是否有文件访问和命令执行能力；连接向导本身只收集信息并生成配置。

接下来助手应该怎么问，你怎么回答

助手会问	你提供什么
“服务器地址是什么？”	管理员给的 IP／域名；不知道就提供你已保存连接的地址栏或连接名称，遮住密码
“平时用什么软件连接？”	例如 VNC Viewer、终端或 SSH 客户端；不知道可以直接说不知道
“端口是多少？是端口还是显示编号？”	把已知值告诉助手。像 `:1`、`:01` 可能是 VNC 显示编号，需要确认实际 TCP 端口
“是否检查这个地址和端口的协议？”	同意后，向导只读取该地址和端口返回的协议标识，用于判断可能是 SSH 还是 VNC；这一步不会登录服务器
“用户名是什么？”	SSH 通常需要 Linux 用户名；有些 VNC 连接只有密码，用户名可暂留空
“是否在本地保存连接信息？”	选择本机保存路径；配置为 `.txt`，密码如需保存则进入系统凭据库
“已有 SSH 权限吗？”	有就继续 SSH 配置；只有 VNC 就按下面的限制处理

只有“服务器端口号＋密码”还不足以确定服务器，至少还需要地址。助手应帮助你找到缺少的信息，而不是反复要求你填写完整技术配置。

如果你只有 VNC

你可以先用向导保存连接信息，继续通过 VNC 查看 Sentaurus。当前 MCP 没有 VNC 自动控制或通过 VNC 自动部署服务器代理的功能；仅有 VNC 密码不能让后台执行器远程接通。

助手应告诉你缺的是哪一项：可用的 SSH 登录方式，或者在服务器本机运行 MCP 客户端的条件。可以把下面这句话发给管理员：

我已有 VNC 远程桌面访问，希望连接 Sentaurus MCP。请确认是否允许 SSH 登录，并提供服务器地址、SSH 端口、Linux 用户名和允许的认证方式；如果不允许 SSH，请确认能否在服务器本机运行 Python MCP 服务及客户端。

想让助手读取已有配置？

先指明具体文件或连接条目，例如：

允许你读取我指定的连接配置文件，提取服务器地址、端口和用户名，
用于设置 Sentaurus MCP。不要读取或输出密码、私钥，不扫描其他目录。
如果格式不支持，请指出还缺哪个字段。

这需要助手本身具备文件访问能力。当前向导的 --load 仅支持本向导生成的配置，不自动解析所有 VNC／SSH 客户端配置。不要为此开放整台电脑或整个用户目录的读取权限。

有经验的用户或负责部署的助手，可以继续看手动安装与部署和远程服务器连接。

能做什么

你想完成的事	当前支持情况
保存输入脚本，建立一个实验	支持；记录输入文件指纹，提交前检查文件是否变化
提交 SDE、SDevice 或 SVisual 批处理任务	已实现调用入口；真实软件命令需在你的安装环境验证
同时提交多个实验	支持排队和最大并行数量设置；默认一次运行一个
查看当前及历史实验	支持查询状态、阶段、进程编号和耗时
查看求解日志	支持增量读取，避免每次传回整份日志
查看产生了哪些结果文件	支持文件清单；暂不解析 TDR 或自动绘图
关闭 AI 客户端后继续计算	独立后台执行器正常运行时，任务可继续
在 Sentaurus Workbench 中直接添加原生工程或实验	尚未实现；当前保存的是批处理目录
自动判断收敛、提取击穿电压或优化器件参数	尚未实现
根据 CPU、内存和许可证自动排满资源	尚未实现；目前只限制并行任务数
单个或多个实验一起打包	alpha.3 本地候选支持，返回服务器 ZIP 路径；客户端下载需使用文件传输
取消任务、重启后自动恢复	尚未实现

实际软件版本

以下仅列出 alpha.3 候选实际覆盖的软件环境，不构成完整兼容性矩阵，也不要求使用者安装完全相同的版本。

项目	已测试范围	说明
Python	3.12	本地 Windows MCP/Worker 测试环境
MCP Python SDK	1.30	本地 MCP 测试环境
pytest	8.4	本地自动化测试环境
Sentaurus TCAD	T-2022.03	Linux 原生工具经操作者提供的 SSH 工具适配器执行过一次小型冒烟任务；适配器不随包提供
部署组合	Windows 本地 MCP/Worker；Linux 运行原生 Sentaurus 工具	未验证 Linux 直接部署 MCP，也未覆盖多平台、多版本兼容矩阵

手动安装与部署

这一节供负责部署的助手或熟悉终端的用户使用。第 1～4 步在 Linux 仿真服务器上操作。 第 5 步仅适用于客户端也在该服务器上；如果客户端在自己的电脑上，请改看远程服务器连接。

1. 准备环境

需要：

Python 3.10 或以上版本。
已安装、可正常批处理运行的 Sentaurus 和有效许可证。
一个你有写入权限的数据目录。
支持 MCP 标准输入输出连接的客户端。

本工具不安装 Sentaurus，也不提供许可证。请先确认同一账号可以直接运行你的仿真脚本。

2. 下载并安装

git clone https://github.com/HanKin666/sentaurus-mcp.git
cd sentaurus-mcp
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e .

3. 配置仿真程序和数据目录

复制示例配置：

cp examples/config.example.json config.json

修改 config.json。以下路径都是占位示例，必须换成你自己的绝对路径：

{
  "root": "/absolute/path/to/experiments",
  "max_parallel": 1,
  "tools": {
    "sde": ["/absolute/path/to/sde", "-e", "-l", "{input}"],
    "sdevice": ["/absolute/path/to/sdevice", "{input}"],
    "svisual": ["/absolute/path/to/svisual", "-b", "{input}"]
  }
}

配置项	含义
`root`	输入、结果、日志及实验索引的存储位置
`max_parallel`	最多同时运行多少个实验；不是每个实验的 CPU 核数
`tools`	允许调用的程序及其参数；需要核对本机 Sentaurus 版本
`{input}`	执行时自动替换为该阶段的输入文件名

许可证、运行库等环境变量沿用服务器已有设置。不要把账号、密码或私有配置提交到仓库。

4. 单独启动后台执行器

在一个独立终端中执行，路径替换为实际配置文件位置：

export SENTAURUS_MCP_CONFIG="/absolute/path/to/sentaurus-mcp/config.json"
sentaurus-worker

保持这个终端运行。长期使用时，可由服务器的服务管理器管理该进程。

后台执行器负责排队和启动仿真，必须独立于 AI 客户端启动。 不要让客户端在启动 MCP 时顺便启动它，否则客户端退出可能影响后台任务。

5. 连接 AI 客户端

下面是客户端与 MCP 在同一台机器时的通用 JSON 配置示例。具体配置文件位置和外层格式由客户端决定：

{
  "mcpServers": {
    "sentaurus": {
      "command": "/absolute/path/to/sentaurus-mcp/.venv/bin/sentaurus-mcp",
      "env": {
        "SENTAURUS_MCP_CONFIG": "/absolute/path/to/sentaurus-mcp/config.json",
        "SENTAURUS_ENABLE_ACTIONS": "1"
      }
    }
  }
}

SENTAURUS_ENABLE_ACTIONS=1：允许建立、提交实验。
改为 0 或不设置：只允许查询。
MCP 和后台执行器必须使用同一个配置文件。
客户端在 Windows、Sentaurus 在 Linux 时，需要配置 SSH 标准输入输出连接，让 MCP 在服务器上运行；不能直接把服务器路径填成 Windows 本地命令。可使用下文的本地配置向导生成连接配置；服务器安装仍需另行完成。
Windows 本地安装时，可执行文件通常位于 .venv/Scripts/sentaurus-mcp.exe；这不代表 Windows 已能运行你的 Sentaurus。

连接成功后，客户端应能发现已安装版本声明的工具。提交前确认后台执行器已经启动。

首次使用：连接诊断与引导

这里有两个不同的操作：配置向导负责询问信息、保存本地配置；环境诊断负责检查程序路径、目录权限以及 Worker 是否在线。两者都不会替你安装或启动服务器上的 Sentaurus。

弹窗或终端问答配置

在自己的电脑上更新安装后运行（将输出路径改到本机合适的数据盘）：

python -m pip install -e '.[setup]'
python -m sentaurus_mcp.setup --gui --output connection-local.txt

去掉 --gui 则在终端逐项询问。弹窗需要 Python 的 Tk 支持；没有桌面或 Tk 时使用终端模式。--load connection-local.txt --output connection-new.txt 可读取指定的旧配置作为默认值，绝不自动扫描其他程序的配置和密码。

向导询问：VNC／SSH／不确定、主机地址、实际 TCP 端口、用户名（VNC 可留空）、认证方式；SSH 还询问服务器 Python 和 MCP 配置路径，未知可先留空。主机:1 可能是 VNC 显示编号，不自动猜为 TCP 端口。选择“不确定”时，仍需要提供端口；可授权读取该端口握手来识别 SSH 或 VNC，不扫描其他端口，不尝试登录。

配置保存为 UTF-8 .txt（内部为 JSON），包含非密码连接信息、状态以及条件满足时生成的只读 MCP 配置；已有文件不覆盖。密码在本地隐藏输入，可选保存到系统凭据库，文本只存凭据引用。安全凭据库不可用时不会退回明文保存；配置仍含服务器地址等信息，请只保存在自己的电脑上。

当前向导不自动使用保存的密码登录，也不安装服务器代理。 保存配置前还需提供服务器地址。VNC 用户的后续步骤见如果你只有 VNC。SSH 后台认证仍需用户配置密钥／认证代理等方案。已有软件“登录成功”与向导“配置已保存”是不同状态。

已在本地测试参数校验、单端口握手、文本配置保存与读取，以及 VNC 终端问答流程；图形弹窗和各平台真实凭据库仍需用户环境验证。切勿把密码发给助手或填入 MCP 工具调用参数。

更新安装后，可让助手调用 diagnose_environment。即使没有配置，也会返回当前主机的环境、配置、存储权限、执行器心跳和程序路径状态；不创建实验目录，不启动仿真，也不验证许可证。

只有 VNC 时，调用 get_connection_guide(mode="vnc") 获取限制说明。有 SSH 时，提供主机、用户名、端口、服务器 Python 和配置路径，生成只读客户端配置。该工具不连接、不自动安装，也不接收密码。

本机终端示例（替换占位内容）：

python -m sentaurus_mcp.doctor
python -m sentaurus_mcp.doctor --mode vnc
python -m sentaurus_mcp.doctor --mode ssh --host server.example.com --user your_user --port 22 --remote-python /absolute/path/.venv/bin/python --remote-config /absolute/path/config.json

最后一条默认仅生成配置；加 --probe 才通过 SSH 执行远程只读诊断。服务器须先安装包含诊断模块的版本。连接检查最多等待 30 秒，不会停止仿真，也不会部署或启动执行器。请先自行准备认证、核对主机密钥。当前向导支持域名和 IPv4，暂不支持 IPv6。

收到远程诊断也不等于许可证有效；未收到时明确标为失败或未检查。部署步骤见手动安装与部署。

远程服务器连接

本机运行 MCP 不需要服务器登录信息；从自己的电脑连接远程服务器时，需要先配置 SSH。 本地连接向导见上文；没有接收密码的 MCP 工具。

需要准备哪些信息

信息	从哪里获取、填在哪里
服务器地址	向管理员获取 IP 或域名，替换示例中的 `server.example.com`
SSH 端口	向管理员确认，替换示例中的 `22`；不要照填 VNC 端口
Linux 用户名	替换 `your_user`，该账号需有实验目录写入权和软件执行权限
登录认证	交互登录可用密码；后台连接建议使用管理员允许的 SSH 密钥或其他非交互认证
MCP 与配置文件路径	填服务器上的绝对路径，必须与独立后台执行器使用的配置一致
Sentaurus 运行环境	在服务器配置软件、许可证及必要环境变量

SSH 用于执行程序，VNC 用于查看远程桌面。 VNC 的显示编号、端口和密码不能当作 SSH 配置；能够打开 VNC 不代表已具备 SSH 登录或仿真权限。

先由你在本地终端测试登录

以下主机名和用户名均为占位内容：

ssh -p 22 [email protected]

首次连接时，向管理员核对服务器主机密钥指纹，再确认保存。若使用密码，由你在 SSH 提示中输入；终端不显示密码字符是正常现象。不要把密码或私钥内容放进 README、客户端配置、命令参数或发给 LLM。

一次密码登录成功，不代表 MCP 后台连接可以自动登录。 多数客户端后台启动 SSH 时没有交互终端。下面的配置明确启用非交互模式，未准备好认证时会直接失败，不会弹出密码框。密钥有口令时，可由你通过本机 SSH 认证代理加载；也可由管理员配置组织允许的认证方案。若只允许逐次输入密码，需要客户端提供安全交互认证能力，当前项目没有实现这一功能。

配置客户端通过 SSH 启动服务器上的 MCP

先按前文在服务器安装 MCP、配置 Sentaurus，并独立启动后台执行器。然后在本机客户端中填写：

{
  "mcpServers": {
    "sentaurus": {
      "command": "ssh",
      "args": [
        "-T",
        "-o",
        "BatchMode=yes",
        "-o",
        "StrictHostKeyChecking=yes",
        "-p",
        "22",
        "[email protected]",
        "env",
        "SENTAURUS_MCP_CONFIG=/absolute/path/to/sentaurus-mcp/config.json",
        "SENTAURUS_ENABLE_ACTIONS=0",
        "/absolute/path/to/sentaurus-mcp/.venv/bin/sentaurus-mcp"
      ]
    }
  }
}

这里的 ssh 是本机的 OpenSSH 客户端；如果不在搜索路径中，改为实际可执行文件路径。后面的 MCP 和配置文件路径都是服务器端路径。示例路径不含空格；远程路径含空格时需正确处理远端 shell 引号，不能直接照搬。

-T 不分配伪终端，让 MCP 使用标准输入输出通信。
BatchMode=yes 禁止交互认证提示；请提前准备认证。
StrictHostKeyChecking=yes 要求主机密钥已核验并保存。
默认 SENTAURUS_ENABLE_ACTIONS=0，先只读检查；需要建立、提交实验时改为 1。
需要指定密钥时，可在主机名前添加 "-i", "/absolute/local/path/to/private_key"，或使用本机 SSH 配置。这里只填写文件路径，不填写密钥内容。
非交互连接未必加载交互登录的环境配置。服务器后台执行器必须具备 Sentaurus 的许可证和运行库环境；MCP 的标准输出也不能混入登录脚本的提示文字。

连接后先让助手列出实验，再测试授权范围内的提交。发现 MCP 工具只证明接口可连接，不证明 Sentaurus 已运行或仿真已通过验证。

常见错误：Permission denied 通常指认证问题；连接拒绝或超时需检查地址、SSH 端口和网络；主机密钥不匹配需向管理员核实，不能直接关闭检查；“执行器不在线”需检查后台进程和配置路径。

这些是连接配置说明，尚未作为本项目的远程端到端测试结果。参数依据：OpenSSH 命令说明、SSH 配置说明。

怎么向助手提问

完成配置并提供你已检查的输入脚本后，可以这样说：

用我提供的 SDevice 输入文件建立实验。先保存输入，告诉我实验编号，暂时不要提交。

提交刚才的实验。随后查询状态，告诉我当前阶段和已用时间。

读取这个实验新增的日志。把日志中的报错与可能原因分开说明，不要自动重跑。

列出这个实验生成的文件，告诉我哪些是日志、哪些是原生结果。

这些是使用方式示例，不是已经完成的仿真结果。助手需要拿到完整脚本；本工具不会自动补齐物理模型，也不会自动认定结果正确。

展开查看工具名称和用途

工具名称	用途
`create_experiment`	保存文本输入和阶段配置，不启动计算
`submit_experiment`	将已准备实验加入队列；重复提交不会重新启动同一实验
`list_experiments`	分页列出历史实验
`get_experiment`	查询状态、输入清单、进程编号及耗时
`read_log`	按字节位置读取一段日志
`list_artifacts`	列出结果文件，不把大型 TDR 文件塞进对话
`diagnose_environment`	只读检查当前主机环境与执行器状态
`get_connection_guide`	生成连接说明或 SSH 配置，不执行登录

输入格式：files 是“文件名 → 文本内容”的字典；stages 是阶段列表，每项包含 tool 和 input_file。工具名必须出现在配置的 tools 中，输入文件必须已提供。当前每个实验的文本输入合计上限为 2 MB。

能力说明也可通过资源 sentaurus://capabilities 读取。

运行原理

一次实验的流程是：保存脚本 → 提交到队列 → Worker 启动 Sentaurus → 查询状态、读取日志和列出结果文件。提交后助手会拿到实验编号，可以之后用这个编号继续查询，无需让同一次对话请求一直等待仿真结束。

实验按“项目 / 实验编号”保存。下面是目录示意，结果文件名由你的脚本决定：

数据目录/
├── experiments.sqlite3       # 实验索引和运行状态
└── 项目名称/
    └── 实验编号/
        ├── 输入脚本
        ├── manifest.json     # 输入指纹和阶段配置
        ├── runner.log        # 执行器日志
        ├── stage-0.log       # 第一阶段日志
        ├── state.json        # 正常结束流程写出的最终状态
        └── 仿真产生的结果文件

同一项目可以保存多个实验，但当前目录不是 Workbench 原生工程。数据库中的运行状态可持续查询，输入和结果文件也独立保留。

常见问题

显示“完成”，就代表仿真正确吗？

不代表。completed 只表示各阶段程序正常退出。数值收敛、物理合理性和指标验收仍需检查，默认验证标签为“未审查”。

对话超时会停止仿真吗？

本工具没有固定的仿真运行时限。独立后台执行器正常工作时，MCP 客户端正常退出不会主动停止仿真。断线后先查询原实验，避免重复建立任务。

服务器关机、进程崩溃或外部调度器终止仍会影响任务；本版本尚不能自动恢复这些情况。

为什么提交不了？

先检查后台执行器是否在线、两个进程是否使用同一配置、是否启用了写入操作，以及输入文件是否在建立实验后被修改。修改过的输入会被指纹检查拒绝，应建立新的实验记录。

为什么一直显示运行中？

先查真实进程和日志。异常退出后状态可能没有及时写回，本版本尚未实现自动校正。不要直接清空运行状态来绕过并发限制。

可以直接读取 TDR 画图吗？

alpha.3 候选可以列出原生文件、按字段名读取 ASCII PLT，并将已结束实验导出为 ZIP。TDR 解析、原生切片图和物理指标自动提取仍未实现。

记录了哪些时间和资源？

记录阶段耗时、总运行耗时、进程编号、操作系统标识和主机可见 CPU 数量。主机 CPU 数量不是本实验实际使用的核数；进程内存峰值、完整硬件配置和优化到达目标的总耗时尚未完整采集。

可以给任意人使用吗？

输入脚本会以运行账号的权限执行，本工具不是脚本沙箱。应只连接可信客户端，并在操作系统或调度器中设置资源和账号权限。

开发与验证

安装测试依赖并运行：

python -m pip install -e '.[test]'
python -m pytest -q

alpha.3 本地候选的自动化验证和单次软件冒烟任务见验证记录。这些结果不等同于跨平台兼容性验收或器件物理验证。

开发背景

本项目将实验准备、批处理任务提交、状态查询和日志读取整理为 MCP 接口。预期部署方式由独立后台执行器启动仿真；VNC 图形界面自动操作、SDE 自动交互建模和原生截图不属于当前功能。alpha.3 的真实软件冒烟路径使用外部 SSH 工具适配器，Linux 端直接部署 MCP 尚未验证，详见验证记录。

参考与许可

说明文档的组织参考了 Playwright MCP 和 MCP Python SDK 的用途介绍、快速开始与分层说明方式。

架构调研参考：Ansys Mechanical MCP、Ansys AEDT MCP、OpenFOAM MCP。本项目独立实现，没有复制这些项目的源代码。

本项目使用官方 MCP Python SDK，版本约束为 >=1.12,<2。

本许可证不授予 Sentaurus 或其他第三方商业软件的使用权；使用者仍需自行取得相应授权。项目非 Synopsys 官方产品，不包含商业软件、手册或授权文件。