跳转到内容
TFStudio Docs

AI 助手（MCP）

TFStudio 可以通过模型上下文协议（MCP）把它的设计工具交给 Claude 等 AI 助手使用。助手随后可以打开和构建设计、计算光谱和评价函数、运行精炼与合成，并把结果保存为 .tfs 文件，供你在应用中打开。它与应用各窗口使用同一套计算代码，因此给出的数值与应用显示的一致。

连接助手

Section titled “连接助手”

已安装的应用本身就是服务器。以 --mcp 启动时，TFStudio 不打开任何窗口，通过标准输入和标准输出与助手通信。应用打开时它也可以同时运行。

Claude Desktop：依次打开 Settings、Developer、Edit Config，在 claude_desktop_config.json 的 mcpServers 下加入 TFStudio，并填写你的安装路径：

{
  "mcpServers": {
    "tfstudio": {
      "command": "C:\\Users\\you\\AppData\\Local\\Programs\\TFStudio\\TFStudio.exe",
      "args": ["--mcp"]
    }
  }
}

Claude Code：在终端中添加。

终端窗口
claude mcp add tfstudio -- "C:\Users\you\AppData\Local\Programs\TFStudio\TFStudio.exe" --mcp

添加服务器后重启助手。

服务器使用应用所用的数据文件夹：默认是 Documents\TFStudio，除非你在首选项中移动过它。它看到的材料，包括你自己的材料目录和库目录，与应用看到的相同。它只读取设计和材料目录，只写入助手保存的 .tfs 文件，已存在的文件只有在助手明确要求时才会被覆盖。此外它在应用旁保留自己的日志 mcp-server.log。

助手能做什么

Section titled “助手能做什么”
类别 工具
设计 openDesign、newDesign、setDesignSetup、saveDesign、showDesign、listDesigns、copyDesign、designDifferences
膜层堆栈 insertLayer、deleteLayer、setLayer、stackFromFormula、cleanDesign、scaleThicknesses、quantize、perturb、flipLayers、copySide、edgeFilter、applyEdgeFilter、needleProfile、insertNeedle
评价函数 setMerit、merit
规格说明 setSpecification、checkSpecification
材料 findMaterials、materialNK、materialDispersion
分析 spectrum、layerSensitivity、indexProfile、layerThicknesses、designFacts、admittance、electricField、color、integrals、ellipsometry、ellipsometryVsAngle、groupDelay、bandFeature、edgeShift、readSpectrumFile、measuredDifference、readEllipsometryFile、addMeasuredCurves、fitMeasured、exportMeasuredCurves、processSteps、exportProcess
运行 refine、synthesize、monteCarlo、jobStatus、stopJob、listJobs
打开的设计（需 --live） listAppDesigns、readAppDesign、applyToApp

spectrum 按光学评估窗口的方式计算 R、T、A、Rs 和 Rp；merit 按评价函数编辑器的显示给出总值和每一行；refine 可运行精炼窗口的任一方法；synthesize 运行针式变化、渐进演化（GE）或结构优化器。monteCarlo 和 layerSensitivity 与蒙特卡洛和层灵敏度窗口的计算相同。评价函数的行使用操作数参考中的操作数。setSpecification 接受规格说明窗口的检查，checkSpecification 按该窗口的方式判定设计是否满足这些检查，并给出每个数值离其界限还有多远；对带有检查的设计，monteCarlo 还会统计良率。cleanDesign 按设计清理器的方式合并相邻的同材料膜层并移除薄层。quantize 和 perturb 按设计编辑器中“取整”和“扰动”对话框的方式对某一面的厚度取整或加上随机误差（可给出种子），flipLayers 和 copySide 对应其“反转”和“复制”按钮，scaleThicknesses 把某一面按同一系数加厚或减薄，designDifferences 列出两个设计之间的不同之处。edgeFilter 按边缘滤光片窗口的方式搜索非偏振边缘滤光片的周期，applyEdgeFilter 按其“替换”或“追加”的方式放入其中一个。needleProfile 按针法手动窗口剖面的方式求出各材料的薄层放在哪里会降低评价函数值，insertNeedle 按其“应用插入”的方式放入一个针层。indexProfile 和 layerThicknesses 按折射率分布和膜层厚度窗口的方式在某一波长处读取膜层堆栈；designFacts 给出总厚度和光学厚度、每种材料的层数以及每层的四分之一波长光学厚度（QWOT），setLayer 也接受 QWOT。admittance 和 electricField 按导纳图和电场窗口的方式，在某一波长处计算一个镀膜面：给出导纳轨迹及每层外表面处的导纳和反射系数，以及穿过膜层的电场、其峰值和峰值所在的膜层。color 和 integrals 计算颜色评估和积分值与特性窗口显示的内容，计算对象为设计的评价对象，并在其入射锥角内取平均：R 或 T 的 CIE 颜色及其各颜色空间、主波长和色温，以及从 Tvis 到 RNIR 的加权平均和你自己的行。ellipsometry 和 ellipsometryVsAngle 按椭偏仪评估窗口的方式计算一个镀膜面的 Ψ 和 Δ：在一个或多个入射角下随波长变化，或在一个波长下随入射角变化；Δ 可采用椭偏仪记录的符号，也可采用相反的符号。groupDelay 按群延迟 / GDD窗口的方式计算一个镀膜面的相位、群延迟、GDD、TOD 和 CDC：反射或透射，按均匀的波长步长或窗口自己的网格；透射时还可按脉冲分析的方式穿过整个元件计算。materialDispersion 按材料色散窗口的方式计算一种材料的平板的相位、群延迟、GDD、CDC 和 TOD 以及材料的群折射率。processSteps 按工艺导出器窗口的方式给出腔体内监控仪在每层之后读到的光谱，工件或监控片均可；exportProcess 写出其“保存”所写的文件。

工作方式

Section titled “工作方式”
  • 按 id 处理设计。 助手处理的是服务器以 d1 等 id 保存的设计。除非服务器以 --live 运行，它的操作不会影响应用中打开的设计；要查看结果，请打开它保存的文件。
  • 完整路径。 文件按完整路径打开和保存，例如 C:\Users\you\Documents\TFStudio\Projects\AR.tfs，因为服务器运行所在的文件夹取决于助手启动它的方式。
  • 运行即任务。 refine、synthesize 和 monteCarlo 在独立线程上启动一个任务，并在半分钟内返回任务状态。对于更长的运行，助手用 jobStatus 跟踪，用 stopJob 停止。改变了设计的运行会把结果作为新设计加入，起始设计保持不变，便于比较。
  • 单位。 波长和膜层厚度单位为 nm，角度为入射介质中的度数，基底厚度单位为 mm。R、T 和 A 为 1 的分数，评价函数目标值也是如此，而评价函数编辑器中显示的是百分比。
  • 拒绝。 拼错的参数、未知的材料或工具无法使用的值都会被拒绝，并给出说明工具接受什么的信息，因此不会按助手未要求的值运行。

处理打开的设计

Section titled “处理打开的设计”

加上 --live 后，助手还可以处理 TFStudio 中打开的设计，你可以看着它变化。在添加服务器的地方，在 --mcp 后面加上 --live，使其参数为：

"args": ["--mcp", "--live"]

在 Claude Code 中，命令以 --mcp --live 结尾。

然后，在让助手处理打开的设计之前，点击 TFStudio 优化选项卡脚本组中的交互。助手工作期间，会有一个窗口挡住应用的其余部分。它显示“正在等待程序连接。”，然后显示“已连接：”和助手的名称。在此期间，你不能编辑、切换设计或启动运行，它后面的各窗口会随着助手的修改继续显示设计。终止会放开助手，把应用交还给你。助手在 TFStudio 没有等待连接时访问它，会被告知需要点击“交互”。

助手读取打开的设计的副本，用上面的工具修改副本，再把它写回：

  • 一步撤销。 它写回的每次修改都是设计历史中的一步，按 Ctrl+Z 即可撤销，并会有通知说明它修改了哪个设计。修改在你保存设计之前一直是未保存的。
  • 只写打开的设计。 助手可以读取项目资源管理器中的任何设计，但只写入当前打开的那一个。
  • 你的编辑优先。 如果设计在助手读取之后发生了变化，无论是编辑、撤销还是运行，它的写入都会被拒绝，并被告知重新读取设计，因此你所做的不会被覆盖。应用的某个窗口中正在运行时，写入也会被拒绝。
  • 运行不打开窗口。 助手启动的精炼或合成在服务器中运行。如果助手要求写回，运行结束时若设计仍与助手读取时相同，结果会作为一步写回。被停止的运行不写入任何内容。
  • 新材料。 服务器在启动时读取材料目录，因此你之后在应用中添加的材料，要在你重启助手后才能被助手使用。

首选项“自动化”中的 TFStudio 启动时开始等待程序连接让 TFStudio 从启动起就等待程序连接，无需点击“交互”，适用于你让其自行工作的助手。此时 TFStudio 会在每个程序首次连接前先询问，提供允许和拒绝，允许后才挡住应用；你拒绝过或用“终止”放开过的程序，只能通过“交互”再次连接。该设置开启期间，你运行的任何程序都可以请求处理你的设计；这台计算机的其他用户无法访问。它默认关闭，因此如非必要请保持关闭。

不加 --live、只处理文件的助手不需要这些：它在你身旁打开和保存 .tfs 文件，应用不必为它等待。