io.github.toki0413/saturday-materials
NPM · @TOKI0413/MCP-SERVER · SCANNED SEP 25
Materials computing tools for AI agents: structures, engines, phonons, EOS, NEB, sampling, lineage.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security99
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 31 of 119 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 3 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability67
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 8784 tokens (~190/item across 46 items; 46 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management38
- Stability check failed: the tool surface changed between 0.3.3 and 0.3.7: 1 tool removals, 13 breaking changes, 17 additions. See how to fix → Fail
Tool Coverage98
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 94% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 46 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 46 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.toki0413/saturday-materials MCP server?
io.github.toki0413/saturday-materials runs locally as an npm package, launched with npx -y @toki0413/mcp-server. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @toki0413/mcp-server
claude mcp add toki0413-saturday-materials -- npx -y @toki0413/mcp-server
{
"mcpServers": {
"toki0413-saturday-materials": {
"command": "npx",
"args": [
"-y",
"@toki0413/mcp-server"
]
}
}
} {
"servers": {
"toki0413-saturday-materials": {
"command": "npx",
"args": [
"-y",
"@toki0413/mcp-server"
]
}
}
} codex mcp add toki0413-saturday-materials -- npx -y @toki0413/mcp-server
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"toki0413-saturday-materials": {
"type": "local",
"command": [
"npx",
"-y",
"@toki0413/mcp-server"
],
"enabled": true
}
}
} openclaw mcp add toki0413-saturday-materials --command npx --arg -y --arg @toki0413/mcp-server
mcp_servers:
toki0413-saturday-materials:
command: "npx"
args: ["-y", "@toki0413/mcp-server"] {
"McpServers": {
"toki0413-saturday-materials": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"@toki0413/mcp-server"
]
}
}
} assistant mcp add toki0413-saturday-materials -t stdio -c npx -a -y @toki0413/mcp-server
{
"mcpServers": {
"toki0413-saturday-materials": {
"command": "npx",
"args": [
"-y",
"@toki0413/mcp-server"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 25 Sept 26 0
- Schema quality: 6229 → 8784 ▼ functional
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 24 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 32 to 35.
- 22 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 25 to 28.
- 20 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 18 to 22.
- 18 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 12 to 15.
- 16 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 5 to 8.
- 12 Sept 26 0
- Stability: unverified → fail ▼ security
- Tool safety: pass → unverified ▼ security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Schema quality: 5165 → 6229 ▼ functional
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
- Package version: 0.3.3 → 0.3.7 functional
- 7 Sept 26 +15
- Malware scan: unverified → pass ▲ security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 25 Sept 2026 · Analysed npm/@toki0413/mcp-server@0.3.7
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 119 packages
| Packages resolved | 119 |
|---|---|
| Stale | 31 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
analysis.elasticity ~264
完整 6×6 弹性刚度张量（Voigt）：6 种独立应变 ± 中心差分共 12 次引擎应力计算，C_ij=∂σ_i/∂ε_j（拉正约定）；派生 VRH 多晶 K/G/E/ν、Born 正定稳定性判据、立方各向异性因子 A=2C44/(C11−C12)。引擎必须声明 calculate+stress 能力（当前：MACE 常驻 batch 档；EMT/LJ 无应力输出即显式拒绝，不做近似替代）。仿射应变无内部弛豫：适用于高对称/单质体系，一般结构声明边界。单位：C 原生 eV/ų，GPa 换算随交付显式声明。
| Name | Type | Req | Description |
|---|---|---|---|
| engine | string | – | 应力源引擎（须声明 calculate 的 stress 性质） |
| eps | number | – | 应变幅值（线性响应有效域 (0,0.05)） |
| materialId | string | yes | 材料 ID（须为平衡附近结构） |
No output schema declared.
No examples provided.
analysis.eos ~228
Birch-Murnaghan 状态方程拟合。两条数据路：(1) 显式传 series=[{volume,energy}]；(2) 传 materialId，按 scales 对各缩放体积做静态单点自产序列（需要 material / potential 服务）。
| Name | Type | Req | Description |
|---|---|---|---|
| B0p0 | number | – | B0′ 初值（常见区间 4–6） |
| engine | string | – | – |
| equation | string | – | 状态方程：'birch-murnaghan'（三阶）或 'vinet'（普适指数，宽体积域更稳） |
| materialId | string | – | 材料 ID（数据路 2） |
| scales | array | – | 体积缩放因子列表，默认 [0.94, 0.97, 1.0, 1.03, 1.06] |
| series | array | – | 显式 (V, E) 序列（数据路 1），每项 { volume, energy } |
No output schema declared.
No examples provided.
analysis.neb ~225
NEB 最小能量路径与过渡态势垒。内置玩具体系 lj-double-well（吸附原子双位跳跃，对称双阱）：端点自动 quench 到两侧极小。climb=true 走 climbing-image NEB（鞍点由 CI 像元给出）。结果附收敛报告（maxForce/逐像元力/maxForce 历史/stepLimitReached）——未收敛时不把带内最高点当成已求得的过渡态。真实势请经编程 API 注入能量/梯度 callable。
| Name | Type | Req | Description |
|---|---|---|---|
| climb | boolean | – | 启用 climbing-image NEB（鞍点由 CI 像元给出） |
| nImages | integer | – | 像元总数（含端点） |
| springK | number | – | 弹性带弹簧常数 |
| system | string | – | 玩具体系名（v0 仅支持 lj-double-well） |
No output schema declared.
No examples provided.
analysis.phonon ~177
Γ 点声子分析（力注入式有限位移）。传 materialId，引擎做静态单点取力（需要 material / potential 服务）；交付频率、虚频与稳定性判定。
| Name | Type | Req | Description |
|---|---|---|---|
| applyAsr | boolean | – | 声学和规则投影 |
| displacement | number | – | 位移步长（Å） |
| engine | string | – | – |
| materialId | string | – | 材料 ID（需已弛豫到平衡附近） |
| stableTolOmegaSq | number | – | 稳定性 ω² 阈值 |
| supercellRep | array | – | 超胞重复数 [nx,ny,nz]；力引擎忽略周期性时必须用超胞（默认 3×3×3） |
No output schema declared.
No examples provided.
analysis.phonon.thermo ~314
全布里渊区声子热力学：从超胞有限位移提取实空间力常数 Φ_{ij}(R)（最近镜像折回小格矢 + 牛顿第三对称 + ASR），经 Born–von Kármán 外推 q 网格得声子谱，交付每原胞 C_v(T)/熵/振动自由能/态密度与 Debye 温度（θ_D=ħω_max/k_B，显式声明）+ Debye 模型对照。需 material/potential 服务；力引擎忽略周期性时用超胞（默认 3×3×3，须覆盖力程）。诚实：有虚频 → valid=false，不假装热力学可信；声学零模（Γ 三支）q→0 测度为零已剔除并报告计数。
| Name | Type | Req | Description |
|---|---|---|---|
| displacement | number | – | 位移步长（Å） |
| engine | string | – | – |
| materialId | string | – | 材料 ID（需已弛豫到平衡附近） |
| mesh | integer | – | Γ 心 q 网格每轴点数（n³ 个 q 点） |
| supercellRep | array | – | 实空间力常数超胞 [nx,ny,nz]（至少一轴>1） |
| temperatures | array | – | 温度网格（K，均 >0） |
No output schema declared.
No examples provided.
analysis.quasiharmonic ~297
准谐近似热膨胀 α(T)/Grüneisen：对种子材料施各向同性体变标度，逐标度算静态能 E_static 与振动自由能 F_vib(V,T)（实空间力常数→Born–von Kármán 格点），合成 F(V,T) 对体积求极小 → V(T)、α=(1/V)dV/dT。准谐=ω随体积变、不含本征非谐；极小在体积网格上求、网格间三点抛物线插值。需 material/potential 服务（引擎需有力）。诚实：数值随网格密疏而定，非解析平衡态。
| Name | Type | Req | Description |
|---|---|---|---|
| displacement | number | – | – |
| engine | string | – | – |
| materialId | string | – | 材料 ID（需已弛豫到平衡附近） |
| mesh | integer | – | 每标度求 F_vib 的 q 网格每轴点数 |
| scales | array | – | 线度标度网格（缺省 [0.97,0.985,1,1.015,1.03]，至少3点） |
| supercellRep | array | – | – |
| temperatures | array | – | 温度网格（K） |
No output schema declared.
No examples provided.
analysis.saddleSearch ~301
QMM 鞍点搜索（不需 NEB 带、不需二阶导 callable）：方向 F_eff=−∇E+2(ĉ·∇E)ĉ，ĉ 取 Hessian 最小特征向量（软模上坡、其余下坡），步长自适应 + 以初值为中心的 trust region。成功需三条同时成立：‖∇E‖<gtol、恰一个负特征值（index-1）、未越出区域；收敛到极小按失败报。内置玩具体系 lj-double-well（鞍点由对称性精确）与 quartic-double-well（鞍点、本征值、势垒全闭式）；真实势请经编程 API 注入 callable。不承诺全局最低势垒。
| Name | Type | Req | Description |
|---|---|---|---|
| c | number | – | quartic-double-well 的四次系数 c（鞍点 (0,0)，势垒 1/(4c)） |
| radius | number | – | trust region 半径（省略用默认 1.5） |
| start | array | – | 初值坐标（quartic 为 2 维、lj 为 3 维） |
| system | string | – | 'quartic-double-well'（闭式基准）| 'lj-double-well' |
No output schema declared.
No examples provided.
derivation.invalidate ~92
失效传播（§8.2）：声明某引用失效并给出原因，沿推导图向下游传递；冻结结果只追加修正记录。返回失效与修正的引用清单。
| Name | Type | Req | Description |
|---|---|---|---|
| reason | string | yes | 失效原因（写入谱系） |
| ref | string | yes | 失效源引用（如 material:<id>） |
No output schema declared.
No examples provided.
derivation.record ~127
登记一条推导：导出量（output）由哪些输入（inputs）经哪个生产者（producer）得出。引用形如 material:<id> / job:<id> / result:<id> / engine:<id>。冻结结果传 frozen（只追加修正、不重算）。
| Name | Type | Req | Description |
|---|---|---|---|
| frozen | boolean | – | 冻结（实验数据/已交付） |
| inputs | array | yes | 输入引用数组 |
| output | string | yes | 输出引用 |
| producer | string | yes | 生产者（工具/引擎名） |
No output schema declared.
No examples provided.
derivation.status ~43
查询导出量的活性状态：valid / invalid、冻结、修正记录与失效来源。
| Name | Type | Req | Description |
|---|---|---|---|
| ref | string | yes | 导出量引用 |
No output schema declared.
No examples provided.
engine.availability ~140
可用性预检：逐已注册引擎探测运行时版本并如实报告（注册 = 声明层，可用 = 运行时层）。探测成功且 stamp=true 时把指纹 version 从声明态 "unknown" 盖章升级为实测值；探测失败保持 "unknown"（不拿未知冒充已知）。同一份代码在不同环境给出不同的表，两种都正确。
| Name | Type | Req | Description |
|---|---|---|---|
| stamp | boolean | – | 探测成功时是否盖章升级指纹实测态（默认只报告不副作用；预检是查询不是变更） |
No output schema declared.
No examples provided.
material.load ~78
加载材料结构。支持化学式（如 "Si"、"TiO2"）；TiO2 等多晶型材料可用 polymorphRank 选择晶型。
| Name | Type | Req | Description |
|---|---|---|---|
| polymorphRank | integer | – | 多晶型序号，默认 0（最稳定） |
| query | string | yes | 化学式 |
No output schema declared.
No examples provided.
potential.relax ~91
对材料做结构弛豫。引擎为 EMT：Python sidecar 有 ASE 时走真实 EMT （UnitCellFilter + BFGS），否则回退 LJ 玩具势（结果中 calculator 字段标明）。
| Name | Type | Req | Description |
|---|---|---|---|
| engine | string | – | – |
| materialId | string | yes | – |
| simulatedSeconds | number | – | 模拟计算耗时（演示长任务） |
No output schema declared.
No examples provided.
runtime.capability.list ~76
运行时能力清单：每个已注册引擎的声明能力（capabilities+properties）、实测指纹（fingerprint+sourceId）、事件粒度、在途作业数与可用性探针结果。自我演化闭环的"当前缺什么"查询面。
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
runtime.engine.attach ~160
运行时挂载引擎插件（不重启宿主、不中断其他插件事件流）：按包名动态 import 并 apply；新引擎即时进 autoRoute 候选池（注册即生效，无握手缓存）；挂载即验证（available() 探针随交付）；凭据/二进制缺失走该插件自己的挂载门禁——providersGained 为空即如实报告不假成功。动作落 Trajectory。
| Name | Type | Req | Description |
|---|---|---|---|
| config | object | – | 传给插件 apply 的配置（如 { resident: true }） |
| plugin | string | yes | 包名（@toki0413/plugin-lammps）或短名（lammps） |
No output schema declared.
No examples provided.
runtime.engine.crossCheck ~179
跨引擎对账（A/B）：把同一 materialId 在两个或多个引擎上回算,机器并列每引擎的 energyPerAtom/单位三元组/指纹 与逐对 deltaEnergyPerAtom;可比性只按单位三元组判(不自动换算),指纹差异如实标注不阻断(差异就是 A/B 要暴露的引擎/版本分歧)。缺引擎/无能量/无能力显式报错。
| Name | Type | Req | Description |
|---|---|---|---|
| engines | array | – | 引擎名列表（≥2；缺省=当前在册全部具该能力引擎） |
| kind | string | – | calculate | relax |
| materialId | string | yes | 被对账的材料 ID |
No output schema declared.
No examples provided.
runtime.engine.detach ~154
运行时拆下引擎：先查作业台账再注销——onActive refuse（缺省，有在途作业即拒 ACTIVE_JOBS）/drain（等到超时，超时可拒）/cancel（无 cancel 通道即 CANCEL_UNSUPPORTED，不假装能停）；经 attach 工具挂载的插件连 fiber 一起回收（服务/工具随 cordis effect 退场）。动作落 Trajectory。
| Name | Type | Req | Description |
|---|---|---|---|
| engine | string | yes | 引擎名（如 lammps / mace / lj-js） |
| onActive | string | – | refuse | drain | cancel |
| timeoutMs | integer | – | drain/cancel 等待预算 |
No output schema declared.
No examples provided.
runtime.engine.rank ~194
跨引擎排序一致性：对一批 materialId 在两个（或多个）引擎回算 energyPerAtom，报两两 Spearman ρ、前 k 重合（取 k 个最小值的索引交/k）、平均绝对差。可比性只按单位三元组判（不自动换算）；不足两引擎/两材料/无能量/无能力显式报错。需 materialId、engines≥2。
| Name | Type | Req | Description |
|---|---|---|---|
| engines | array | – | 引擎名（≥2；缺省=在册全部具该能力引擎） |
| k | integer | – | 前 k 重合的 k（缺省 min(3, 材料数)） |
| kind | string | – | calculate | relax |
| materialIds | array | yes | 候选材料 ID（≥2，同一批） |
No output schema declared.
No examples provided.
sampler.anchor.add ~218
混合提案锚点入库：闭环产出的参考结构（已注册材料或直交付 graph）入会话锚点库；谱系必填（无来源声明的数据不入库）；组分自动从结构提取（可覆写）。入库即声明：锚点来自闭环轨迹，出处可追溯。
| Name | Type | Req | Description |
|---|---|---|---|
| composition | object | – | 组分覆写（缺省从结构节点原子序机械提取） |
| energy | number | – | 锚点能量（可选，闭环回算产出；入库只做记录不参与检索排序） |
| graph | object | – | 直交付结构（含非空 nodes；与 materialId 二选一） |
| materialId | string | – | 已注册材料 ID（与 graph 二选一） |
| source | string | – | 谱系声明（直交付时必填；材料入库缺省声明为 material:<id>） |
No output schema declared.
No examples provided.
sampler.anchor.audit ~152
审计调用方指定路径载荷的血缘完整率（只读，不回填）：逐条目三态——可追溯（来源归一化为 material:/job:）/不可追溯（有来源但非可追溯形态）/损坏（版本戳缺失或来源缺失，回填必拒）；非可追溯条目附修复建议（指明出路，不代改）；异常如实入报告，不连坐。
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | – | 单载荷文件路径（与 paths 二选一） |
| paths | array | – | 多载荷文件路径（与 path 二选一） |
No output schema declared.
No examples provided.
sampler.anchor.export ~71
导出会话锚点库全量条目（无损 JSON 有效载荷）：跨会话持久化的原语。库自身不落盘——导出交付由调用方保存与回填（诚实边界：不伪造库外数据）。
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
sampler.anchor.import ~101
从导出载荷回填锚点：逐条入库（谱系门禁复用库层：无来源即拒），同谱系已在库则跳过（导入幂等，重放安全）。返回入库/跳过/拒绝明细。
| Name | Type | Req | Description |
|---|---|---|---|
| entries | array | – | 导出载荷的 entries 数组（每项 {graph, source, composition?, formula?, energy?}） |
No output schema declared.
No examples provided.
sampler.anchor.load ~186
从调用方指定路径回填锚点（落盘载荷 → 会话库，支持 path 单载荷或 paths 多载荷合并）：门禁先行——全部文件先过完整性检查（读/解析/版本/size/条目版本戳），全过才开始回填（出错时库零污染）；回填复用导入门禁（谱系/本体/幂等同款）；交付附逐文件明细与 lineageRefs（磁盘数据起点的可追溯声明）。
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | – | 单载荷文件路径（与 paths 二选一，调用方显式声明） |
| paths | array | – | 多载荷文件路径（与 path 二选一；同谱系幂等门禁天然兜底跨载荷重复） |
No output schema declared.
No examples provided.
sampler.anchor.repair ~148
载荷侧修复原语（写新载荷，不碰原件）：对审计报告中不可追溯条目逐条显式声明可追溯起源；损坏条目与已可追溯条目不接受修复（修复不是伪造，也不替调用方做决定）。
| Name | Type | Req | Description |
|---|---|---|---|
| out | string | – | 修复后载荷写出路径（必须与 path 不同） |
| path | string | – | 待修复载荷路径 |
| repairs | array | – | 逐条修复声明：[{ index, source }]（source 必须为 material:/job: 形态） |
No output schema declared.
No examples provided.
sampler.anchor.save ~80
把会话锚点库落盘到调用方指定路径（导出载荷的磁盘端）：无损 JSON，跨会话恢复用 sampler.anchor.load。路径显式声明（库不自作主张读写文件系统）。
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | – | 目标文件路径（调用方显式声明） |
No output schema declared.
No examples provided.
sampler.anchor.stats ~69
会话锚点库容量观测（只读，不变更）：条目数 + 谱系形态分布（material:/job:/其他）+ 组分声明覆盖——与 sampler.anchor.audit（库外载荷观测）构成双观测面。
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
sampler.flow ~236
仿射耦合流参考结构采样（§4.5 采样语义，invertible 首实证）：潜变量 z ~ N(0, I) 经双射输运映射为位移向量，叠加参考结构得候选；似然经换元公式精确可求（logProb 逐候选可独立重算），encode 可把候选映回潜变量。候选是分布上的采样点而非唯一解；流参数由 seed 派生（非训练产物，如实声明）；请送入引擎回算验证后再使用。
| Name | Type | Req | Description |
|---|---|---|---|
| n | integer | – | 候选数量 |
| referenceId | string | yes | 参考结构材料 ID |
| sMax | number | – | 微分同胚窗口半宽（Å）：位移 |d| < sMax + 0.1，窗口外 encode 显式拒绝 |
| seed | integer | – | 随机种子（同时决定流参数与潜变量抽样；确定性复现） |
No output schema declared.
No examples provided.
sampler.flow.encode ~174
双射输运映射的反向（契约：仅 invertible === true 提供）：把与参考结构同拓扑的候选 graph 映回潜变量（encode(decode(z)) ≡ z）。窗口外结构显式拒绝（不外推冒充覆盖）；跨拓扑显式拒绝（位移无定义）。
| Name | Type | Req | Description |
|---|---|---|---|
| graph | object | – | 待编码结构（AtomGraph：nodes[].position 逐坐标） |
| referenceId | string | yes | 参考结构材料 ID（位移空间的定义基准） |
| sMax | number | – | 微分同胚窗口半宽（必须与生成时一致） |
| seed | integer | – | 随机种子（必须与生成时一致：seed 决定流参数） |
No output schema declared.
No examples provided.
sampler.mixture ~387
锚点引导的混合采样：从会话锚点库检索（拓扑硬门禁 + 组分 L1 距离）→ 最大余数法配额 → OU 混合提案（似然 exact，逐候选可独立重算）。空库/无匹配显式报错（不伪造锚点）；候选不自证，请送入引擎回算后接 workflow.screen（sampled 透传）。也支持 anchors 内联（单次调用即用，不经过会话库）。
| Name | Type | Req | Description |
|---|---|---|---|
| anchors | array | – | 内联锚点（与库检索二选一）：每项 {"graph":{...},"source":"...","composition":{...},"weight":1} |
| batchId | string | – | 提案批次标识（可选；缺省随机生成，用于推导登记簿引用对账） |
| composition | object | – | 目标组分（检索排序偏好；缺省只按拓扑过滤） |
| gammaDt | number | – | γΔ 无量纲摩擦时间尺度积 |
| n | integer | – | 候选数量 |
| nAtoms | integer | – | 拓扑门禁（会话库路径必填） |
| seed | integer | – | 随机种子（确定性复现） |
| temperatureK | number | – | 采样器自身温度声明（可选；声明 ≠ 替换） |
| topK | integer | – | 参与混合的锚点数上限 |
| uEq | number | – | 平衡态每坐标涨落幅度（Å） |
| weights | array | – | 混合权重（与检索结果等长；缺省均匀） |
No output schema declared.
No examples provided.
sampler.ou ~250
OU 参考结构采样（§4.5 采样语义）：均值回归锚定 referenceId 的受控扩散，采样 n 个候选并附精确提议似然（logProb）。候选是分布上的采样点而非唯一解；局部采样器（盆地内），请送入引擎回算验证后再使用。
| Name | Type | Req | Description |
|---|---|---|---|
| gammaDt | number | – | γΔ 无量纲摩擦时间尺度积（小→贴近参考，大→近平稳） |
| n | integer | – | 候选数量 |
| referenceId | string | yes | 参考结构材料 ID |
| seed | integer | – | 随机种子（确定性复现） |
| temperatureK | number | – | 采样器自身温度声明（可选；声明 ≠ 替换：不改变采样行为，只随交付呈现供消费方做温差诚实核对；标定建议值可用 uEqFromHarmonicTemperature 换算） |
| uEq | number | – | 平衡态每坐标涨落幅度（Å） |
No output schema declared.
No examples provided.
sampler.perturb ~140
参考结构微扰采样（§4.5 采样语义）：在 referenceId 结构的邻域内采样 n 个候选。候选是分布上的采样点而非唯一解；似然不可求（已如实声明），请送入引擎回算验证后再使用。
| Name | Type | Req | Description |
|---|---|---|---|
| n | integer | – | 候选数量 |
| referenceId | string | yes | 参考结构材料 ID |
| seed | integer | – | 随机种子（确定性复现） |
| sigma | number | – | 笛卡尔位移标准差（Å） |
No output schema declared.
No examples provided.
sampler.rss ~357
RSS 随机结构搜索采样（§4.5 采样语义，非 flow 生成式路线）：在成分/原子数/晶胞约束下均匀生成随机晶体结构候选（正交晶胞 + 最小间距门禁），不依赖参考结构拓扑。候选是均匀提议分布的采样点而非唯一解；提议分布经门禁截断后归一化常数无闭式，似然如实声明 none（不伪造）；请送入引擎回算验证后再使用（workflow.explore / 逐候选弛豫）。
| Name | Type | Req | Description |
|---|---|---|---|
| aMax | number | – | 正交晶胞边长上界（Å） |
| aMin | number | – | 正交晶胞边长下界（Å） |
| counts | array | – | 各元素原子数（与 elements 等长，如 [3,1]） |
| elements | array | – | 元素符号数组（与 counts 搭配，如 ["Cu","Pt"]）；与 referenceId 二选一 |
| maxAttempts | integer | – | 单原子放置重试上限（耗尽即显式报错） |
| minDistance | number | – | 最小原子间距门禁（Å，最小像约定） |
| n | integer | – | 候选数量 |
| referenceId | string | – | 参考结构材料 ID：成分自其 graph 继承（结构本身不参考）；与 elements 二选一 |
| seed | integer | – | 随机种子（确定性复现） |
No output schema declared.
No examples provided.
sampler.trigger.snapshot.load ~75
判据快照回填（只读校验后原样交付）：校验版本戳与形态，快照不进锚点库、不进数据燃料——结论依据跨会话可续供、可复算。
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | – | 快照文件路径 |
No output schema declared.
No examples provided.
sampler.trigger.snapshot.save ~154
判据快照落盘（跨会话续供）：判据对账结论整体原样落盘——读数/阈值/结论一并保留，落盘不改判（不替调用方改写结论）。
| Name | Type | Req | Description |
|---|---|---|---|
| assessment | object | – | 判据对账结论（trajectoryTriggerAssessment 交付） |
| batchId | string | – | 判据批次标识 |
| path | string | – | 快照落盘路径 |
| triggerRef | string | – | 可选：对账结论的推导引用（对账登记交付的 result:trigger-<batchId>），声明即随快照原样落盘 |
No output schema declared.
No examples provided.
structure.fromCif ~124
CIF 文本 → 周期 Material（P1 子集：_cell 参数还原晶胞 + _atom_site 分数/笛卡尔坐标）。零依赖不需 sidecar。materialId 供 relax/calculate/phonon/xrd/筛选下游。不支持对称性操作与非整比占位：显式报 CIF_SYMMETRY_UNSUPPORTED / CIF_OCCUPANCY_UNSUPPORTED，不自动展开。
| Name | Type | Req | Description |
|---|---|---|---|
| text | string | yes | CIF 结构文本（P1、显式原子列表） |
No output schema declared.
No examples provided.
structure.fromPoscar ~115
VASP POSCAR 文本 → 周期 Material（解析 lattice/按元素分组/分数或笛卡尔坐标）。零依赖、任何环境可跑（不需 RDKit/sidecar），产物 materialId 供 relax/calculate/phonon/xrd/筛选下游。未知元素 POSCAR_NO_SYMBOLS、截断/奇异胞显式报错不猜。
| Name | Type | Req | Description |
|---|---|---|---|
| text | string | yes | POSCAR / VASP CONTCAR 结构文本 |
No output schema declared.
No examples provided.
structure.fromSmiles ~135
SMILES → 3D 分子结构（RDKit ETKDG 嵌入 + MMFF/UFF 力场弛豫）。分子体系 pbc=False（无周期边界），可走 relaxation/calculate/声子等下游工具。需 sidecar Python 含 RDKit（缺失显式报错，不冒充可用）。
| Name | Type | Req | Description |
|---|---|---|---|
| seed | integer | – | 构象嵌入随机种子（确定性复现） |
| smiles | string | yes | SMILES 表达式（如 "CO"、"c1ccccc1"） |
No output schema declared.
No examples provided.
structure.fromXyz ~120
XYZ 文本 → Material（分子/非周期：零胞 + pbc=false，同 structure.fromSmiles 语义）。首行原子数与后续行不匹配、未知元素、非有限坐标显式报错不猜。零依赖不需 sidecar。产物 materialId 供 relaxation/calculate/声子等下游（分子体系无周期性分析）。
| Name | Type | Req | Description |
|---|---|---|---|
| text | string | yes | XYZ 结构文本（count / comment / "符号 x y z" …） |
No output schema declared.
No examples provided.
trajectory.replay ~88
回放 Trajectory（append-only 事件流）：重建材料计算索引。可选把每条记录以 "saturday/replay/..." 事件重放给监听者。
| Name | Type | Req | Description |
|---|---|---|---|
| reemit | boolean | – | 是否把记录重放为广播事件，默认 false |
| trajectoryPath | string | – | 轨迹文件路径（默认本插件运行时配置） |
No output schema declared.
No examples provided.
workflow.activeLearning ~283
basin-hopping 主动学习闭环（§4.3+§4.5 迭代版）：每轮从当前最优结构微扰产候选→引擎 relax 回算→能量更低则更新中心与最优。引擎是唯一 oracle（无 GP 代理，非贝叶斯优化）；候选是采样分布点非唯一解；history 最优能量按构造单调不升，不声明全局最优。逐轮回算落 Trajectory（含 round/谱系）。提议器可选 sampler/<name>（缺省 reference-perturbation）。需 material/potential/sampler 服务。
| Name | Type | Req | Description |
|---|---|---|---|
| candidatesPerRound | integer | – | 每轮候选数 |
| engine | string | – | – |
| referenceId | string | yes | 种子结构材料 ID |
| rounds | integer | – | 主动学习轮数 |
| sampler | string | – | 提议器服务名 sampler/<name>（每轮从当前最优结构生成候选；可换 ou/flow/rss 等） |
| seed | integer | – | 随机种子（第 r 轮用 seed+r，确定性复现） |
| sigma | number | – | 微扰位移标准差（Å，仅对微扰类 sampler 生效） |
No output schema declared.
No examples provided.
workflow.bayesOptimize ~223
GP 代理贝叶斯优化（1D，极小化昂贵黑箱）：对种子材料施体变标度 x（各向同性缩放），引擎 calculate 回算 E(x)/原子作 oracle，高斯过程（RBF+Cholesky）建模、LCB 采集选下一评估点，少回算逼近极小（平衡体积代理）。不声明全局最优（启发式）；缺 material/potential 服务显式报错。需 material / potential 服务。
| Name | Type | Req | Description |
|---|---|---|---|
| engine | string | – | – |
| iterations | integer | – | LCB 采集迭代数（另加 3 个冷启动点） |
| kappa | number | – | LCB 探索系数（越大越偏探索） |
| materialId | string | yes | 种子材料 ID |
| scaleRange | array | – | 体变标度区间 [lo,hi]（缺省 [0.9,1.1]） |
No output schema declared.
No examples provided.
workflow.bayesOptimizePareto ~230
多目标（2）GP 贝叶斯优化：对种子材料体变标度 x，两目标 = [每原子能量 E/n, 最大残余力范数 max|F|]（均最小化）——低能与“平衡附近小力”常不在同一 x，构成权衡。逐目标独立 GP + 超体积增益采集，返回观测非支配前沿与超体积。引擎为唯一 oracle；不声明收敛到真实 Pareto 前沿（后验均值贪心采集）。需 material/potential（引擎需回能量与力）。
| Name | Type | Req | Description |
|---|---|---|---|
| engine | string | – | – |
| iterations | integer | – | 采集迭代数（另加 3 个冷启动点） |
| materialId | string | yes | 种子材料 ID |
| scaleRange | array | – | 体变标度区间 [lo,hi]（缺省 [0.92,1.08]） |
No output schema declared.
No examples provided.
workflow.ergodic ~362
遍历对账（§4.5 oracle 条款）：采样候选的能量系综平均 对 同一能量函数恒温 MD 的时间平均。判定强度随采样器似然声明三档分级：likelihood: none 时为信息性量化；声明似然可求且候选附 logProb 时做重要性重加权，重加权均值对 MD 时间平均，构成对 Boltzmann 采样声明的直接检验。
| Name | Type | Req | Description |
|---|---|---|---|
| dtFs | number | – | MD 时间步长（fs） |
| engine | string | – | 能量函数（引擎名，须支持 calculate 与 md） |
| gammaDt | number | – | OU 无量纲摩擦时间尺度积 γΔ（OU 采样器用） |
| mdSeed | integer | – | MD 随机种子（确定性复现） |
| mdSteps | integer | – | MD 步数 |
| n | integer | – | 采样候选数量（系综侧） |
| referenceId | string | yes | 参考结构材料 ID（MD 起点） |
| sampler | string | – | 采样器服务名（如 reference-perturbation / ou-perturbation） |
| seed | integer | – | 采样种子 |
| sigma | number | – | 微扰位移标准差（Å，微扰采样器用） |
| temperatureK | number | – | MD 温度（K） |
| tolerance | number | – | 均值差容差（eV） |
| uEq | number | – | OU 平衡态每坐标涨落幅度（Å，OU 采样器用） |
No output schema declared.
No examples provided.
workflow.explore ~222
采样 → 回算闭环（§4.5 oracle 条款）：采样器在 referenceId 结构邻域产生候选，每个候选独立送入引擎弛豫验证后按能量排序。候选是分布采样点而非唯一解，能量为引擎回算结果，全程谱系可溯源。
| Name | Type | Req | Description |
|---|---|---|---|
| engine | string | – | 引擎选择（validation 画像） |
| n | integer | – | 候选数量 |
| referenceId | string | yes | 参考结构材料 ID |
| sampler | string | – | 提议器服务名 sampler/<name>（如 ou-perturbation / affine-flow / rss；缺省微扰） |
| seed | integer | – | 随机种子（确定性复现） |
| sigma | number | – | 微扰位移标准差（Å，仅对微扰类 sampler 生效） |
| topK | integer | – | 只返回能量最低的前 K 个 |
No output schema declared.
No examples provided.
workflow.freeEnergy ~355
热力学第二档：构型自由能曲线。逐温度网格点恒温 MD 得 ⟨U⟩(β)，沿 β 热力学积分（d(βF_conf)/dβ = ⟨U⟩），锚点显式声明。交付的是构型自由能（不含动量部分）；锚点以外只承诺 ΔF 的积分正确性。
| Name | Type | Req | Description |
|---|---|---|---|
| anchorF0 | number | – | 锚点自由能 F₀（eV；anchorMode=explicit 时必填） |
| anchorMode | string | – | 锚点模式：explicit = 调用方显式声明 anchorF0；harmonic = 引擎 harmonic 原语计算（弛豫+Hessian 简正模，量子谐振子闭式） |
| anchorSource | string | – | 锚点物理来源声明（如"谐波近似"/"���验值"） |
| anchorTemperatureK | number | yes | 锚点温度（必须是网格点） |
| dtFs | number | – | MD 时间步长（fs） |
| engine | string | – | 能量函数（引擎名，须支持 md） |
| mdSteps | integer | – | 每网格点 MD 步数 |
| referenceId | string | yes | 参考结构材料 ID（MD 起点） |
| sampleEvery | integer | – | MD 能量采样间隔（步） |
| seed | integer | – | MD 随机种子（确定性复现） |
| temperatures | array | yes | 温度网格（K，升序，≥2 点） |
No output schema declared.
No examples provided.
workflow.screen ~589
批量掺杂筛选：基体 + 掺杂变体逐个弛豫，按能量排序。每个变体独立落 Trajectory，可全程溯源。支持元素：Cu Ag Al Ni Au Pd Pt（EMT 范围）。
| Name | Type | Req | Description |
|---|---|---|---|
| batchId | string | – | 筛选批次号（活性上下文登记用，缺省自动生成） |
| codopants | array | – | 共掺变体列表，如 [{"elements":["Pt","Ni"],"sites":[0,1]}]；落在稳定相连线上的物理内点 |
| dopants | array | yes | 掺杂元素列表，如 ["Ag","Ni"] |
| engine | string | – | – |
| evidenceSources | array | – | 枚举候选联合排序的额外证据源（显式启用，缺省只按能量排）；内置 ["hull"]（凸包距离，需参考态）与 ["mixing-entropy"]（理想混合熵组分先验，只消费组分）；可同启，退化关联由机器审计随交付呈现 |
| materialId | string | yes | 基体材料 ID |
| maxDopedSites | integer | – | 每掺杂的最大取代位数（浓度扫描：1..max 各一个变体；不得超过基体可取代位数） |
| proposalRef | string | – | 提案推导引用（可选；如 "result:mixture-<batchId>"，来自 sampler.mixture 的交付）：声明后登记为排序层推导输入——提案失效沿推导图传播到排序（锚点→提案→排序全链活性） |
| sampled | array | – | 采样候选（通常来自 sampler.ou 的交付）：每项 {"materialId":"...","logProb":-12.3}（已注册材料）或 {"graph":{...},"source":"...","logProb":-12.3}（§4.5 SampledStructure 透传）；逐候选单点回算后与似然证据联合排序（需提供 temperatureK） |
| sampledSource | string | – | 采样来源声明（如 "sampler.ou"；似然语义随交付呈现，不默认） |
| samplerTemperatureK | number | – | 采样器声明的自身温度（K，可选）；与 temperatureK 不一致时随交付诚实声明温差不纠正 |
| temperatureK | number | – | 联合排序目标温度（K；提供 sampled 或 evidenceSources 时必填） |
| topK | integer | – | 只返回能量最低的前 K 个 |
No output schema declared.
No examples provided.
What is the io.github.toki0413/saturday-materials MCP server?
io.github.toki0413/saturday-materials is an MCP server listed in the public MCP registry as io.github.toki0413/saturday-materials. Materials computing tools for AI agents: structures, engines, phonons, EOS, NEB, sampling, lineage. This page covers its npm package (@toki0413/mcp-server).
Is the io.github.toki0413/saturday-materials MCP server safe to use?
io.github.toki0413/saturday-materials scores 74 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 25 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.toki0413/saturday-materials MCP server expose?
io.github.toki0413/saturday-materials exposes 46 tools: material.load, structure.fromSmiles, structure.fromPoscar, structure.fromXyz, structure.fromCif, and 41 more. Their descriptions and schemas cost roughly 8,784 tokens of context every time the server is loaded.
Is the io.github.toki0413/saturday-materials MCP server still maintained?
io.github.toki0413/saturday-materials is still listed as active in the MCP registry. We last reached this channel on 25 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.toki0413/saturday-materials MCP server under?
io.github.toki0413/saturday-materials declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.