DrYe1109/MS-MCP

External MCP server for BIOVIA Materials Studio with guided Windows setup, GUI Dashboard, Forcite, DMol3 and CASTEP workflows.

About MS-MCP

面向 Windows 与 BIOVIA Materials Studio 的外部 Model Context Protocol（MCP）服务器。它让 Codex 或其他 MCP 客户端通过官方 MaterialsScript 运行时执行建模、Forcite、DMol3、CASTEP、GUI 队列和结果读取，并提供本地 Dashboard。

当前版本：0.2.0。项目不是 BIOVIA/Dassault Systèmes 官方产品；使用前请确认 Materials Studio 许可证及 MaterialsScript 组件可用。

- 检查 Materials Studio、RunMatScript.bat、工作区和会话状态。 - 创建/导入结构，维护当前 GUI 文档，并执行常用结构编辑。 - 执行 Forcite、DMol3、CASTEP 任务与预设工作流。 - 通过可选的 Materials Studio GUI 循环把脚本送入当前打开的项目。 - 从受限 HTTPS 白名单下载 CIF，并限制响应大小。 - 准备远程 CASTEP 任务，Dashboard 可通过 SSH 只读监控 Gateway 作业目录。 - 所有生成文件默认限制在独立工作区；任意 MaterialsScript 和外部输入默认关闭。

- Windows 10/11（64 位）。 - BIOVIA Materials Studio，且已安装 MaterialsScript；必须能找到： MSINSTALLROOT\etc\Scripting\bin\RunMatScript.bat。 - Node.js 20 或更高版本，包含 npm.cmd。 - Codex 或其他支持 stdio MCP 的客户端。 - 可选：Windows OpenSSH Client（只在远程 Dashboard 监控时使用）。

下载 Release 压缩包或克隆仓库后，不要把项目放入随后会删除或改名的临时目录。推荐路径如 C:\Tools\MS-MCP。

1. 双击 Configure-MS-MCP.bat，逐项确认 Node、Materials Studio、工作区等路径。 2. 双击 Install-MS-MCP.bat，以 npm ci 安装锁定依赖并检查发布文件。 3. 双击 Test-MS-MCP.bat，验证路径、安全默认值和 MCP stdio 通信。 4. 打开生成的 config\codex-ms-mcp.local.toml，把完整内容合并到 %USERPROFILE%\.codex\config.toml。 5. 完全退出并重启 Codex，在 MCP 列表中确认 MS-MCP 可用。

Configure-MS-MCP.bat 是唯一推荐的本机配置入口，内部调用 PowerShell 完成验证和安全写入：

- config\ms-mcp.local.bat：供启动、测试、Dashboard、GUI 循环和 SSH 脚本统一读取。 - config\codex-ms-mcp.local.toml：供复制到 Codex 的 MCP 配置块。

这两个文件包含本机绝对路径，已由 .gitignore 排除，不能上传 GitHub。仓库只保留不含真实机器信息的 config\ms-mcp.example.bat、.mcp.example.json 和 codex-ms-mcp.toml.example。

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/DrYe1109--MS-MCP.html)

Related MCP servers