poker-mcp 1.5.0 → 1.8.2

package/README.md

@@ -4,13 +4,161 @@ YAML-based input file management tool for radiation-shielding calculation code P
 
 ## 📋 クイック情報
 
-- **バージョン**: 1.5.0
+- **バージョン**: 1.6.0
 - **プロトコル**: MCP (Model Context Protocol) 1.0.0 完全準拠
 - **メインサーバー**: `src/mcp_server_stdio_v4.js`
 - **データ保存**: `~/.poker-mcp/`（`POKER_MCP_HOME`環境変数で変更可）
 - **核種データ**: `${POKER_INSTALL_PATH}/LIB/ICRP-07.NDX` を直接参照
 - **実行方式**: STDIO通信（MCPプロトコル標準）
 
+## 🆕 バージョン1.8.0〜1.8.1の新機能
+
+### 📐 CAD連携が MCP だけで完結
+従来、CAD からの経路抽出は MCP を経由せず、FreeCAD を手で起動する必要が
+ありました。`spec.json` を手書きし、`poker_cui -p` を叩き、`freecadcmd` に
+スクリプトを渡す。3 手順すべてが手作業でした。
+
+```javascript
+poker_generatePaths({ fcstd: "C:/path/to/model.FCStd" })
+poker_executeCalculation({ yaml_file: "poker.yaml", path_input: "poker.paths" })
+```
+
+CAD ファイルを指定するだけになりました。分割点の取得、グリッド検出器の展開、
+ビルドアップ等価材料の解決（`Source_Dry` → `Tungsten` など）は自動です。
+
+### 🔍 FREECAD_PATH
+FreeCAD の場所を、環境変数 → PATH → 既定のインストール先の順で解決します。
+`POKER_INSTALL_PATH` のように固定の既定値を持てないのは、インストール先が
+バージョン番号を含むためです（FreeCAD 1.1, 1.0 …）。
+
+```json
+"env": {
+  "POKER_INSTALL_PATH": "C:\\Poker",
+  "FREECAD_PATH": "C:\\Program Files\\FreeCAD 1.1"
+}
+```
+
+### 🐛 相対パスの解決を修正
+`tasks/` 配下のファイル名指定が、プロセスのカレントディレクトリを基準に
+解決されていました。MCP サーバの起動場所によっては別の場所を指します。
+
+
+## 🆕 バージョン1.7.0〜1.7.2の新機能
+
+### 📉 サマリー出力量の制御（ThinnedIndices 操作系 3メソッド）
+`thinnedindices` ノードを MCP から設定できます。`.paths` の生成では全ての
+線源分割点と検出器評価点が必要ですが、既定では間引かれるため手で書き足す
+必要がありました。
+
+```javascript
+poker_updateThinnedIndices({ fit_for_paths: true })
+// → 入力の分割定義と検出器グリッドから必要数を計算して設定
+```
+
+既定値は poker_mcp 側で持ちません。省略しても `.summary` には全 7 キーが
+値付きで出力されるので、そちらを正とします。
+
+### 🔄 保留中の変更が `get` で見えるように
+`propose` の直後に `get` を呼ぶと変更が見えず、「反映されていない」と誤解する
+余地がありました。確定値とは別に `pending` として示します。
+
+```javascript
+poker_proposeThinnedIndices({ sourcepoint: 100 })
+poker_getThinnedIndices()
+// → { thinnedindices: null, pending: { sourcepoint: 100 }, pending_count: 1 }
+```
+
+### 🛡️ `.paths` の座標照合
+件数だけでなく座標も YAML と突き合わせます。検出器を動かして `.paths` を
+再生成し忘れると、件数は変わらないため従来は通り抜け、**静かに誤った線量**が
+出ていました。
+
+
+## 🆕 バージョン1.6.0の新機能
+
+### 🧱 カスタム材料をライブラリ追加だけで使えるように
+材料の一覧・密度範囲・ビルドアップ可用性をコード側に持たず、すべて
+`%POKER_INSTALL_PATH%/LIB/` から読み込むようにしました。**カスタム材料を
+`lib_material.dat` に追記すれば、コード変更なしにサーバ再起動だけで
+ゾーン定義・密度検証・等価材料の自動選定すべてに反映されます。**
+
+標準材料を追加する場合は `lib_material.dat` と `lib_setting.dat` の
+`buildup_material` の両方に登録します（片方だけなら警告が出ます）。
+
+### 🔀 ビルドアップ等価材料の選定を実データ方式へ
+従来の光子実効Z最近傍は暫定実装でした。ビルドアップを支配するのは散乱と吸収の
+競合であることから、POKER の減衰係数ファイルから
+`μ_incoherent / (μ_total − μ_incoherent)` を求め、0.1〜3 MeV の11点で
+最も一致する標準材料を選びます。
+
+一致度スコアを応答に付けるようにしました。0.30 を超える場合は「標準材料に
+近いものが無い」ことを意味し、候補上位3件とともに警告を出します。黙って粗い
+代用材を当てるより、どの程度粗いかを見せる方が判断材料になります。
+
+この変更で `Source_Dry` の等価材料は `Lead` から `Tungsten` に変わります。
+
+### 🐛 `poker_updateBuildupFactor` が equivalent を更新できない問題を修正
+ツールスキーマと `DataManager` の双方に `equivalent` が無く、`TaskManager`
+だけが素通しする三層不整合でした。変更・解除（空文字指定）に対応し、
+標準材料への指定や非標準材料の指定を拒否する検証も追加しています。
+
+### 📡 CAD連携レイトレース
+FreeCAD のソリッドモデルを、STEP のような中間フォーマットを介さず、CSG で
+表現し直す作業も無しに遮蔽体系として扱えます。**MCP の 2 呼び出しで完結**します。
+
+```javascript
+poker_generatePaths({ fcstd: "C:/path/to/model.FCStd" })
+poker_executeCalculation({ yaml_file: "poker.yaml", path_input: "poker.paths" })
+```
+
+線源点→検出器の直線を FreeCAD 側で追跡し、通過した材質と厚さを `.paths` に
+記録して POKER に渡します。分割点の取得、グリッド検出器の展開、ビルドアップ
+等価材料の解決はすべて自動です。
+
+CSG 経由と一致することを平板・円筒・球の 5 体系で確認済みです。フィレットや
+自由曲面のように CSG で表現できない形状も扱えます。**複数線源・グリッド検出器・
+スラント補正に対応**。
+
+他の CAD で作ったモデルも、STEP で FreeCAD に読み込めば同じパイプラインに
+乗ります。副産物として、POKER の改造なしで使える**簡易化の監査ツール**
+（ある形状を省略してよいかを定量化する）もあります。
+
+FreeCAD の場所は環境変数 `FREECAD_PATH` で指定します（未設定なら既定の
+インストール先を探索）。
+
+#### 必要なもの
+
+| | 入手 | 環境変数 |
+|---|---|---|
+| poker-mcp | `npm install poker-mcp` | — |
+| **POKER 本体** | 別途入手 | `POKER_INSTALL_PATH` |
+| **FreeCAD** | [freecad.org](https://www.freecad.org/)（無償） | `FREECAD_PATH` |
+
+numpy はレイトレーサが使いますが、FreeCAD に同梱されているので追加の
+インストールは不要です。
+
+```json
+"env": {
+  "POKER_MCP_HOME": "C:\\Users\\yoshi\\poker_mcp_workspace",
+  "POKER_INSTALL_PATH": "C:\\Poker",
+  "FREECAD_PATH": "C:\\Program Files\\FreeCAD 1.1"
+}
+```
+
+`FREECAD_PATH` は既定の場所にインストールされていれば省略できます。
+
+#### モデル側の約束
+
+**ソリッドに `PokerMaterial` プロパティで材質名を設定**しておく必要があります
+（`Iron`、`Concrete` など、POKER の材料ライブラリの名前）。密度を上書きする場合は
+`PokerDensity` も設定します。
+
+他の CAD で作ったモデルを STEP で読み込んだ場合、材質情報は失われるので
+FreeCAD 上で設定してください。一度設定すれば `.FCStd` に保存されます。
+
+詳細は [CAD_RAYTRACE.md](./docs/manuals/CAD_RAYTRACE.md)、フォーマットは
+[PATHS_FORMAT.md](./docs/manuals/PATHS_FORMAT.md)。
+
 ## 🆕 バージョン1.5.0の新機能
 
 ### 🖥️ POKER GUI を閉じずに表示を切り替え
@@ -33,8 +181,6 @@ YAML-based input file management tool for radiation-shielding calculation code P
 乱数で「正常」を出力する監視スクリプトなど、実態と乖離した記述を削除し、
 検証可能な手順のみに整理しています。
 
-詳細は [CHANGELOG.md](./CHANGELOG.md) を参照。
-
 ## 🆕 バージョン1.4.0の新機能
 
 ### ☢️ 子孫核種の自動管理
@@ -255,7 +401,7 @@ Claude Desktopで以下のようにテストできます：
 ## 🏆 主要機能
 
 ### ✅ **MCP完全対応**
-- **30メソッド完全実装**: 全ての放射線遮蔽計算入力管理機能
+- **34メソッド完全実装**: 全ての放射線遮蔽計算入力管理機能
 - **JSON-RPC 2.0準拠**: 標準プロトコル完全対応
 - **STDIO通信**: MCPクライアントとの標準通信方式
 - **自動バックアップ・ロールバック**: 企業品質のデータ保護
@@ -274,7 +420,7 @@ Claude Desktopで以下のようにテストできます：
 
 ## 🎯 API構成
 
-### 🔧 **30メソッド完全実装**
+### 🔧 **34メソッド完全実装**
 
 | **カテゴリ** | **メソッド数** | **機能** | **主要操作** |
 |-------------|---------------|----------|-------------|
@@ -287,7 +433,7 @@ Claude Desktopで以下のようにテストできます：
 | **📏 Unit** | 5個 | 単位設定管理 | propose・get・update・validateIntegrity・analyzeConversion |
 | **⚙️ System** | 6個 | システム制御 | applyChanges・executeCalculation・resetYaml・confirmDaughterNuclides・openGui・各種検証 |
 
-### 📋 **全30メソッド一覧**
+### 📋 **全34メソッド一覧**
 ```
 Body系 (3):          poker_proposeBody, poker_updateBody, poker_deleteBody
 Zone系 (3):          poker_proposeZone, poker_updateZone, poker_deleteZone  

package/package.json

@@ -1,55 +1,61 @@
-{
-  "name": "poker-mcp",
-  "version": "1.5.0",
-  "description": "YAML-based input file management tool for radiation shielding calculation code POKER with MCP support - Enhanced with collision detection, daughter nuclide auto-completion, and environment variable support",
-  "main": "src/mcp_server_stdio_v4.js",
-  "type": "module",
-  "bin": {
-    "poker-mcp": "src/mcp_server_stdio_v4.js"
-  },
-  "scripts": {
-    "start": "node src/mcp_server_stdio_v4.js",
-    "dev": "nodemon src/mcp_server_stdio_v4.js",
-    "prepare": "echo 'NPX ready: npx poker-mcp'",
-    "check:manifest": "node scripts/check-manifest-sync.mjs"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "yaml",
-    "radiation",
-    "shielding",
-    "nuclear",
-    "radioisotope",
-    "medical",
-    "accelerator",
-    "POKER",
-    "physics",
-    "validation",
-    "npx",
-    "point-kernel",
-    "collision-detection",
-    "daughter-nuclide"
-  ],
-  "author": "Yoshihiro Hirao <tora@pointkernel.com>",
-  "license": "ISC",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Hirao-Y/poker_mcp.git"
-  },
-  "homepage": "https://github.com/Hirao-Y/poker_mcp#readme",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "js-yaml": "^4.1.0",
-    "winston": "^3.17.0",
-    "zod": "^3.24.2"
-  },
-  "files": [
-    "src/",
-    "README.md",
-    ".mcp.json"
-  ]
-}
+{
+  "name": "poker-mcp",
+  "version": "1.8.2",
+  "description": "YAML-based input file management tool for radiation shielding calculation code POKER with MCP support - Enhanced with collision detection, daughter nuclide auto-completion, and environment variable support",
+  "main": "src/mcp_server_stdio_v4.js",
+  "type": "module",
+  "bin": {
+    "poker-mcp": "src/mcp_server_stdio_v4.js"
+  },
+  "scripts": {
+    "start": "node src/mcp_server_stdio_v4.js",
+    "dev": "nodemon src/mcp_server_stdio_v4.js",
+    "prepare": "echo 'NPX ready: npx poker-mcp'",
+    "check:manifest": "node scripts/check-manifest-sync.mjs",
+    "test:pending": "node tests/pending-view.test.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "yaml",
+    "radiation",
+    "shielding",
+    "nuclear",
+    "radioisotope",
+    "medical",
+    "accelerator",
+    "POKER",
+    "physics",
+    "validation",
+    "npx",
+    "point-kernel",
+    "collision-detection",
+    "daughter-nuclide"
+  ],
+  "author": "Yoshihiro Hirao <tora@pointkernel.com>",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hirao-Y/poker_mcp.git"
+  },
+  "homepage": "https://github.com/Hirao-Y/poker_mcp#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "js-yaml": "^4.1.0",
+    "winston": "^3.17.0",
+    "zod": "^3.24.2"
+  },
+  "files": [
+    "src/",
+    "tools/gen_paths.py",
+    "tools/ray_trace_tri.py",
+    "tools/poker_lib.py",
+    "tools/audit_mfp.py",
+    "tools/compare_poker_trace.py",
+    "README.md",
+    ".mcp.json"
+  ]
+}

package/src/mcp/handlers/cadHandlers.js

@@ -0,0 +1,187 @@
+// mcp/handlers/cadHandlers.js
+//
+// CAD 連携レイトレース。従来は次の 3 手順を手で行う必要があった。
+//   1. spec.json を手書き（絶対パスを 4 箇所）
+//   2. poker_cui -p で分割点と評価点を出す
+//   3. freecadcmd を起動して gen_paths.py を走らせる
+// このハンドラがまとめて行う。
+
+import { spawn } from 'child_process';
+import fs from 'fs/promises';
+import fssync from 'fs';
+import path from 'path';
+import { FREECAD_CMD, CAD_TOOLS_DIR, POKER_INSTALL_DIR, TASKS_DIR, YAML_FILE }
+  from '../../utils/paths.js';
+import { logger } from '../../utils/logger.js';
+import { MaterialCatalog } from '../../utils/MaterialCatalog.js';
+
+function run(cmd, args, opts = {}) {
+  return new Promise((resolve) => {
+    const p = spawn(cmd, args, { ...opts, stdio: ['ignore', 'pipe', 'pipe'] });
+    let out = '', err = '';
+    p.stdout.on('data', d => out += d);
+    p.stderr.on('data', d => err += d);
+    p.on('error', e => resolve({ code: -1, out, err: e.message }));
+    p.on('close', code => resolve({ code, out, err }));
+  });
+}
+
+export function createCadHandlers(taskManager) {
+  return {
+    async generatePaths(args) {
+      const fail = (msg, hint) => ({
+        content: [{
+          type: 'text',
+          text: JSON.stringify({ success: false, error: msg, hint }, null, 2)
+        }],
+        isError: true
+      });
+
+      // --- FreeCAD の所在 ---
+      if (!FREECAD_CMD) {
+        return fail(
+          'FreeCAD が見つかりません',
+          '環境変数 FREECAD_PATH に freecadcmd の場所を設定してください。' +
+          '実行ファイル（C:/Program Files/FreeCAD 1.1/bin/freecadcmd.exe）でも、' +
+          'インストールフォルダ（C:/Program Files/FreeCAD 1.1）でも指定できます。' +
+          'claude_desktop_config.json の env に追加します。');
+      }
+      if (!args || !args.fcstd) return fail('fcstd を指定してください');
+      if (!fssync.existsSync(args.fcstd))
+        return fail('CAD ファイルが見つかりません: ' + args.fcstd);
+
+      const yamlFile = YAML_FILE;
+      if (!fssync.existsSync(yamlFile))
+        return fail('入力 YAML がありません: ' + yamlFile,
+          'applyChanges で入力を確定してから実行してください。');
+
+      // --- 1. poker_cui -p で分割点と評価点を出す ---
+      // .paths には全点が必要。間引かれていると gen_paths.py がエラーにする。
+      const exe = path.join(POKER_INSTALL_DIR, 'poker_cui.EXE');
+      if (!fssync.existsSync(exe))
+        return fail('poker_cui が見つかりません: ' + exe,
+          '環境変数 POKER_INSTALL_PATH を確認してください。');
+
+      const summary = yamlFile + '.summary';
+      const r1 = await run(exe, [yamlFile, '-p', '-t'], { cwd: TASKS_DIR });
+      if (r1.code !== 0 || !fssync.existsSync(summary)) {
+        return fail('poker_cui -p の実行に失敗しました（終了コード ' + r1.code + '）',
+          (r1.err || r1.out || '').slice(-400));
+      }
+
+      // --- 2. spec を組み立てる ---
+      const out = args.output || path.join(TASKS_DIR, 'poker.paths');
+      const spec = {
+        fcstd: args.fcstd.replace(/\\/g, '/'),
+        out: out.replace(/\\/g, '/'),
+        poker_summary: summary.replace(/\\/g, '/'),
+        detectors_from_summary: true,
+        deviation: args.deviation ?? 0.5,
+        unit_scale: args.unit_scale ?? 0.1,
+        poker_dir: POKER_INSTALL_DIR.replace(/\\/g, '/'),
+        mu_energy: args.mu_energy ?? 1.25,
+      };
+      if (args.source_name) spec.source_name = args.source_name;
+      if (args.buildup_exclude) spec.buildup_exclude = args.buildup_exclude;
+      if (args.chunk) spec.chunk = args.chunk;
+
+      // カスタム材料のビルドアップ等価材料を自動で解決する。
+      //   gen_paths.py は層の縮約先を決める際、単層ビルドアップデータの有無を
+      //   材料名で照合する。Source_Dry のようなカスタム材料は標準材料に
+      //   読み替える必要があり、従来は spec.equivalent に手で書いていた。
+      //   MaterialCatalog が lib_equivalent.dat と実データから解決できるので
+      //   ここで埋める（POKER 側も同じ表を見るので食い違わない）。
+      try {
+        const data = taskManager.data || {};
+        const equiv = {};
+        for (const z of (data.zone || [])) {
+          const m = z.material;
+          if (!m || m === 'VOID' || equiv[m]) continue;
+          if (MaterialCatalog.isStandard && MaterialCatalog.isStandard(m)) continue;
+          const e = MaterialCatalog.nearestBuildupEquivalent(m);
+          const name = (e && typeof e === 'object') ? e.equivalent : e;
+          if (name) equiv[m] = name;
+        }
+        if (Object.keys(equiv).length) {
+          spec.equivalent = equiv;
+          logger.info('ビルドアップ等価材料を自動設定しました', { equivalent: equiv });
+        }
+      } catch (e) {
+        logger.warn('等価材料の自動解決に失敗（spec.equivalent なしで続行）',
+          { error: e.message });
+      }
+
+      const specFile = path.join(TASKS_DIR, '.generate_paths_spec.json');
+      await fs.writeFile(specFile, JSON.stringify(spec, null, 2), 'utf8');
+
+      // --- 3. FreeCAD をヘッドレスで起動してトレース ---
+      // GUI の MCP ブリッジ経由では、数万レイのトレースが GUI スレッドを
+      // 占有してブリッジが壊れる。freecadcmd を使う。
+      const script =
+        'import sys, json, traceback\n' +
+        'sys.path.insert(0, r"' + CAD_TOOLS_DIR + '")\n' +
+        'try:\n' +
+        '    import gen_paths\n' +
+        '    gen_paths.main(r"' + specFile + '")\n' +
+        '    print("GEN_PATHS_OK")\n' +
+        'except BaseException:\n' +
+        '    print("GEN_PATHS_ERROR")\n' +
+        '    traceback.print_exc()\n';
+
+      const scriptFile = path.join(TASKS_DIR, '.generate_paths.py');
+      await fs.writeFile(scriptFile, script, 'utf8');
+
+      const r2 = await run(FREECAD_CMD, [scriptFile], { cwd: TASKS_DIR });
+      const log = (r2.out || '') + (r2.err || '');
+
+      if (!log.includes('GEN_PATHS_OK') || !fssync.existsSync(out)) {
+        // Python のトレースバックから要点を抜く
+        const m = log.match(/(?:SystemExit|Error|Exception)[^\n]*(?:\n[^\n]*){0,3}/);
+        return fail('経路の生成に失敗しました',
+          m ? m[0].trim() : log.slice(-500));
+      }
+
+      // --- 4. 生成結果を要約する ---
+      const text = await fs.readFile(out, 'utf8');
+      const info = {};
+      for (const key of ['n_sources', 'n_source_points', 'n_detectors', 'n_materials',
+                         'format_version', 'deviation_mm']) {
+        const m = text.match(new RegExp('^\\s*' + key + ':\\s*(.+)$', 'm'));
+        if (m) info[key] = m[1].trim();
+      }
+      const nPaths = (text.split('paths: |')[1] || '').trim().split('\n').length;
+
+      logger.info('経路ファイルを生成しました', { out, ...info });
+
+      return {
+        content: [{
+          type: 'text',
+          text: JSON.stringify({
+            success: true,
+            message: '経路ファイルを生成しました',
+            output: out,
+            summary: {
+              経路数: nPaths,
+              線源数: info.n_sources,
+              線源点数: info.n_source_points,
+              検出器評価点数: info.n_detectors,
+              材質数: info.n_materials,
+              テッセレーション偏差_mm: info.deviation_mm,
+              format_version: info.format_version
+            },
+            spec_used: {
+              deviation: spec.deviation,
+              unit_scale: spec.unit_scale,
+              mu_energy: spec.mu_energy,
+              buildup_exclude: spec.buildup_exclude ?? ['VOID', 'Air'],
+              equivalent: spec.equivalent ?? {},
+              freecad: FREECAD_CMD,
+              poker_dir: spec.poker_dir
+            },
+            next: 'poker_cui "' + yamlFile + '" --path-input "' + out + '" -t で計算できます'
+          }, null, 2)
+        }]
+      };
+    }
+  };
+}

package/src/mcp/handlers/calculationHandlers.js

@@ -115,7 +115,8 @@ export function createCalculationHandlers(taskManager) {
           summaryOptions,
           resolvedOutputFiles,
           undefined,
-          taskManager.dataManager
+          taskManager.dataManager,
+          args.path_input || null
         );
 
         // 事前検証で重大エラーが検出された場合の処理

package/src/mcp/handlers/index.js

@@ -5,7 +5,9 @@ import { createTransformHandlers } from './transformHandlers.js';
 import { createBuildupFactorHandlers } from './buildupFactorHandlers.js';
 import { createSourceHandlers } from './sourceHandlers.js';
 import { createDetectorHandlers } from './detectorHandlers.js';
-import { createUnitHandlers } from './unitHandlers.js';
+import { createUnitHandlers } from './unitHandlers.js';
+import { createThinnedIndicesHandlers } from './thinnedIndicesHandlers.js';
+import { createCadHandlers } from './cadHandlers.js';
 import { createCalculationHandlers } from './calculationHandlers.js';
 import { resetHandlers } from './resetHandlers.js';
 import { createDaughterNuclideHandler } from './daughterNuclideHandler.js';
@@ -32,7 +34,9 @@ export function createAllHandlers(taskManager) {
     ...createDetectorHandlers(taskManager),
     
     // 単位操作
-    ...createUnitHandlers(taskManager),
+    ...createUnitHandlers(taskManager),
+    ...createThinnedIndicesHandlers(taskManager),
+    ...createCadHandlers(taskManager),
     
     // 計算操作
     ...createCalculationHandlers(taskManager),

package/src/mcp/handlers/resetHandlers.js

@@ -1,6 +1,7 @@
 // handlers/resetHandlers.js - YAML初期化ハンドラー
 import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
 import { logger } from '../../utils/logger.js';
+import { MaterialCatalog } from '../../utils/MaterialCatalog.js';
 
 /**
  * poker_resetYaml ハンドラー
@@ -49,12 +50,9 @@ export function createResetYamlHandler(taskManager) {
         throw new McpError(ErrorCode.InvalidParams, `reset_level は ${validResetLevels.join(', ')} のいずれかである必要があります`);
       }
 
-      const validMaterials = [
-        'Carbon', 'Concrete', 'Iron', 'Lead', 'Aluminium', 'Copper', 'Tungsten',
-        'Air', 'Water', 'PyrexGlass', 'AcrylicResin', 'Polyethylene', 'Soil', 'VOID'
-      ];
-      if (!validMaterials.includes(atmosphere_material)) {
-        throw new McpError(ErrorCode.InvalidParams, `atmosphere_material は ${validMaterials.join(', ')} のいずれかである必要があります`);
+      if (!MaterialCatalog.has(atmosphere_material)) {
+        throw new McpError(ErrorCode.InvalidParams,
+          `atmosphere_material は ${MaterialCatalog.allMaterials().join(', ')} のいずれかである必要があります`);
       }
 
       // VOID材料の密度指定チェック

package/src/mcp/handlers/thinnedIndicesHandlers.js

@@ -0,0 +1,48 @@
+// mcp/handlers/thinnedIndicesHandlers.js
+//
+// thinnedindices（サマリー出力量の制御）のハンドラ。
+// 既定値は poker_mcp 側で持たず、POKER の .summary に出力される値を正とする。
+
+import { logger } from '../../utils/logger.js';
+
+export function createThinnedIndicesHandlers(taskManager) {
+  return {
+    async proposeThinnedIndices(args) {
+      const result = await taskManager.proposeThinnedIndices(args || {});
+      return {
+        content: [{
+          type: 'text',
+          text: JSON.stringify({
+            success: true,
+            message: 'thinnedindices を提案しました（applyChanges で確定）',
+            ...result
+          }, null, 2)
+        }]
+      };
+    },
+
+    async getThinnedIndices() {
+      const result = await taskManager.getThinnedIndices();
+      return {
+        content: [{
+          type: 'text',
+          text: JSON.stringify(result, null, 2)
+        }]
+      };
+    },
+
+    async updateThinnedIndices(args) {
+      const result = await taskManager.updateThinnedIndices(args || {});
+      const msg = (args && args.fit_for_paths)
+        ? 'thinnedindices を更新しました（入力の分割数・評価点数に合わせました）'
+        : 'thinnedindices を更新しました（applyChanges で確定）';
+      logger.info(msg, { indices: result.thinnedindices });
+      return {
+        content: [{
+          type: 'text',
+          text: JSON.stringify({ success: true, message: msg, ...result }, null, 2)
+        }]
+      };
+    }
+  };
+}

package/src/mcp/tools/buildupFactorTools.js

@@ -12,7 +12,7 @@ export const buildupFactorTools = [
         },
         equivalent: {
           type: 'string',
-          description: '非標準材料のビルドアップ等価材料（省略時は組成の光子実効Zで最近傍の標準材料を自動選択）'
+          description: '非標準材料のビルドアップ等価材料（標準材料名）。省略時は組成の散乱/吸収比を実用エネルギー帯域で照合して自動選択'
         },
         use_slant_correction: {
           type: 'boolean',
@@ -45,6 +45,10 @@ export const buildupFactorTools = [
         use_finite_medium_correction: {
           type: 'boolean',
           description: '新しい有限媒体補正設定'
+        },
+        equivalent: {
+          type: 'string',
+          description: '非標準材料のビルドアップ等価材料（標準材料名）。空文字を指定すると等価材料の指定を解除します'
         }
       },
       required: ['material']