内容
# CONVERGE Studio MCP
一个非官方的本地模型上下文协议服务器，用于在Windows上自动化CONVERGE Studio 5。它结合了一个TypeScript MCP服务器和一个PowerShell和Studio JavaScript桥。
服务器公开：
- 25个MCP工具：Studio、CSI、CGM、GUI、覆盖率和有界原始求解器操作。
- 兼容的53命令Studio桥。
- 153个CSI方法和55个CGM方法的分类目录。
- 13章、248条记录的功能矩阵。
- 一个原始的中文功能摘要，省略了重新分发的供应商文本、页面图像、布局、示例、资产、本地路径和凭证。
- 工作副本默认值、显式突变门、路径允许列表、有界输出和PID验证的求解器作业控制。
此仓库不包含任何CONVERGE二进制文件、许可证、手册、客户案例、几何体或求解器输出。需要单独许可的本地CONVERGE Studio安装。
## 仓库布局
```text
studio-mcp/ TypeScript MCP服务器、测试、目录和公共文档
studio-js/ PowerShell启动器、Windows GUI驱动程序和Studio JavaScript后端
```
保持这些目录作为兄弟目录。MCP服务器默认发现`../studio-js`。
## 需求
- Windows 10/11，附带Windows PowerShell 5.1
- Node.js 20或更新版本
- 授权的CONVERGE Studio 5.x安装
- 供应商`CONVERGE_Studio.cmd`启动器
故意拒绝直接启动`CONVERGE_Studio.exe`。
## 构建和验证
```powershell
git clone https://github.com/Legiiiit/converge-studio-mcp.git
Set-Location .\converge-studio-mcp\studio-mcp
npm ci
npm run check
npm test
npm run smoke
npm audit
```
默认的烟雾测试不会启动Studio。实时Studio、GUI和求解器执行测试需要授权的本地安装和显式选择加入环境变量。
## 在Codex中注册
先构建，然后注册编译的stdio服务器：
```powershell
$repo = (Resolve-Path .\converge-studio-mcp).Path
codex mcp add converge-studio `
--env "CONVERGE_STUDIO_CMD=D:\Program Files\Convergent Science\CONVERGE CFD\5.1.1\CONVERGE_Studio\x64\bin\CONVERGE_Studio.cmd" `
-- "C:\Program Files\nodejs\node.exe" "$repo\studio-mcp\dist\src\index.js"
```
Studio发现还检查传统的`C:`和`D:`程序文件位置。除非提供相应的环境和调用级别确认，否则所有突变、GUI、求解器文件写入、启动和停止功能仍保持禁用或双重门控。
参见 [完整的MCP文档](studio-mcp/README.md)、[净化的中文功能摘要](studio-mcp/resources/manual-digest.zh-CN.md)和 [生成的覆盖率矩阵](studio-mcp/coverage/coverage-matrix.md)。
## GitHub Actions
CI运行目录/覆盖率偏移检查、严格的TypeScript构建、单元/协议测试、stdio烟雾测试和依赖项审计。它故意不运行CONVERGE Studio，因为GitHub托管的运行器没有获得许可的Windows应用程序或交互式桌面。
## 项目状态
基线是CONVERGE Studio 5.1.1。其他5.x版本使用运行时发现和显式功能状态；不支持、内部、不可用和未经验证的功能不会被报告为已验证。
## 许可证和商标
此仓库中的原始源代码可在 [MIT License](LICENSE) 下使用。CONVERGE、CONVERGE Studio和相关名称是其各自所有者的商标。本社区项目与Convergent Science无关，也未得到其支持或赞助。
