免费了解积分 →
MP
材料Materials Project API /summary

Materials Project

Materials Project 是设在劳伦斯伯克利国家实验室的开放数据库,收录无机材料的 DFT 计算性质。通过 ScholarMuse,agent 可以按化学式、精确的元素组合或 mp-id 找到条目,读取计算得到的带隙、形成能、稳定性、密度和晶体结构概要。同一个工具还会同时查询 OQMD 和 Crystallography Open Database。

对应的 ScholarMuse 工具:lookup_material。每次成功调用都会扣积分。

可以这样问你的 agent

TiO2 各个多晶型的计算带隙和凸包上方能量分别是多少?
查一下 mp-2657(金红石型 TiO2):空间群、晶格参数和密度。
恰好由 Li、Fe、P、O 四种元素组成的热力学稳定化合物有哪些?

你的 agent 会拿到什么

每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 Materials Project 的数据字段。

lookup_material

source 为 materials-project 的记录,数值为 DFT 计算值;这些条目不提供 CIF 链接。

materialId
API 返回的 Materials Project id,如 mp-aaaaadyf
formula
约化化学式
spacegroup
空间群符号
spacegroupNumber
空间群编号
crystalSystem
晶系
lattice
a、b、c、alpha、beta、gamma 和晶胞体积
sites
晶胞中的原子位点数
bandGapEv
计算带隙(eV)
formationEnergyPerAtomEv
形成能(eV/原子)
energyAboveHullEv
凸包上方能量(eV/原子)
isStable
该相位于凸包上时为 true
densityGcm3
密度(g/cm3)
method
固定为 DFT (computed)
experimentallyObserved
条目被标为 theoretical 时为 false

覆盖范围

  • Materials Project summary 数据集中的条目,已弃用的条目不包含在内。
  • 可按化学式、1 到 8 个元素符号的列表(恰好由这些元素组成的材料),或 mp-2657 这样的 mp-id 查询。
  • 结果按凸包上方能量排序,最稳定的相排在前面;stable_only 只保留位于凸包上的相。

限制

  • 每次最多返回 30 个条目(默认 10 个),这个上限与 OQMD、COD 共用:各数据源的结果交替排列,直到达到上限。
  • 数值是 DFT 计算值,不是实测值。不返回 CIF 文件和原子坐标,只有晶格概要和条目页面链接。
  • API 现在返回的是字母形式的 id(查 mp-2657 得到的是 mp-aaaaadyf)。两种形式都可以用来再次查询同一个条目。
  • lattice 描述的是 Materials Project 存储的晶胞,往往不是惯用晶胞:锐钛矿型 TiO2 返回的是 c = 5.50 Å、夹角 110°,而惯用晶胞的 c 约为 9.5 Å。
  • 只返回概要性质,不含弹性、磁性、介电、声子和电池相关数据。
  • 化学式只能由元素符号和数字组成,例如 LiFePO4;带括号的写法和材料名称会被拒绝。

ScholarMuse 怎么访问 Materials Project

连接器直接请求 api.materialsproject.org/materials/summary,并在 X-API-KEY 请求头里带上 ScholarMuse 自己的 API key。服务器没有配置这个 key 时,这个数据源不返回任何内容,工具会把它报告为不可用。

响应最多缓存 7 天,Materials Project 新版数据库带来的变化可能要过这么久才能看到。

API key:上游 API 需要 key,ScholarMuse 用自己的 key,你不用申请。

许可与署名

许可:CC BY 4.0

Data from the Materials Project (materialsproject.org), CC BY 4.0. Cite: A. Jain et al., APL Materials 1, 011002 (2013).

来自 Materials Project 的记录都带这段许可和署名。 在论文里引用时,请按 Materials Project 自己的引用要求来写。

常见问题

ScholarMuse 不是 Materials Project 的官方产品。它是一个面向学术数据的 MCP server,其中的 lookup_material 工具会查询 Materials Project。agent 连上 ScholarMuse 后就能用 Materials Project,不用再单独装一个 server。

不需要。Materials Project 的 API 需要 key,ScholarMuse 用自己的 key 调用。登录一次 ScholarMuse,agent 就能调用工具。

连接器直接请求 api.materialsproject.org/materials/summary,并在 X-API-KEY 请求头里带上 ScholarMuse 自己的 API key。服务器没有配置这个 key 时,这个数据源不返回任何内容,工具会把它报告为不可用。响应最多缓存 7 天,Materials Project 新版数据库带来的变化可能要过这么久才能看到。

许可:CC BY 4.0。署名:Data from the Materials Project (materialsproject.org), CC BY 4.0. Cite: A. Jain et al., APL Materials 1, 011002 (2013). 来自 Materials Project 的记录都带这段许可和署名。

需要。每次成功调用 lookup_material 都会扣积分,调用失败不扣。当前价格:化合物与材料,1 积分 / 次。