LLM-MatGen 0.2.1：已有材料优先通过 MP 获取

LLM-MatGen 0.2.1：已有材料优先从 Materials Project 搜索获取。

默认流程：MP 搜索 → 确定材料编号及晶型 → 下载母结构 → 生成所需构型 → 查看离线球棍模型。

• 接通 MCP search 与 download，使用已有 MPCollector 接口；保留下载文件和结构哈希。
• 多个晶型匹配时先确定目标，不默认选第一条；密钥缺失或无匹配时明确报告。
• 明确提供本地文件或要求离线时仍可直接使用本地结构。
• 保留 v0.2.0 球棍模型与 --open 功能。

需要通过环境变量 MP_API_KEY 提供 MP 密钥，不将密钥传入工具参数。

验证：44 项相关测试通过；真实 MP 查询及 mp-149 下载成功；安装包入口验证通过。全量测试中的原有集群路径发布检查提示仍未修复。

安装：python -m pip install --upgrade ./llm_matgen-0.2.1-py3-none-any.whl
完整源码位于本发布的 tar.gz 附件。

LLM-MatGen 0.2.0：生成后直接查看球棍模型

LLM-MatGen 0.2.0：生成后直接查看结构。

• 十类结构生成流程默认输出离线 viewer.html 球棍模型。
• 支持旋转、缩放、平移、候选切换、晶胞、原子编号、点击多选和 XY/XZ/YZ 视角。
• 支持生成后使用 --open 直接打开浏览器。
• 吸附结果可切换查看干净表面参考；预览记录在 manifest 中。
• MCP generate 已接通实际生成工具，返回查看页面路径与 HTML 资源。
• 内置 3Dmol.js 2.0.4 及许可证，打开页面不需要联网。

安装：

python -m pip install --upgrade ./llm_matgen-0.2.0-py3-none-any.whl
llm-matgen generate vacancy --input Si.cif --target-element Si --count 1 --output-root output --open

需要 Python 3.10 或以上，安装时联网下载 Python 依赖。完整源码请下载发布附件 llm_matgen-0.2.0.tar.gz。

预览仅显示晶胞内的几何连接，不计算能量或改变结构。单结构预览限 20000 原子，整页限 200000 原子；超过限制时保留结构结果并记录预览提示。

验证：安装包内置资源及实际渲染已验证；浏览器检查包括模型显示、编号、视角、候选切换和原子点选。原有发布文本检查对集群绝对路径的提示仍存在。

LLM-MatGen 0.1.0

LLM-MatGen 0.1.0。项目名称已恢复为 LLM-MatGen。

需要 Python 3.10 或以上。下载安装 llm_matgen-0.1.0-py3-none-any.whl：

python -m pip install ./llm_matgen-0.1.0-py3-none-any.whl
llm-matgen --help

安装时联网下载依赖。保留 dft-structure-building 命令作为兼容入口。

当前源码请下载 llm_matgen-0.1.0.tar.gz，校验文件为 LLM-MatGen-SHA256SUMS.txt。旧名称附件仅作为历史版本保留。仓库的自动 Source code 附件不包含完整应用源码。

66 项相关测试通过，wheel 安装和入口已验证。