poker-mcp 1.5.0 → 1.7.2

package/README.md

@@ -4,13 +4,96 @@ 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.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 で
+表現し直す作業も無しに遮蔽体系として扱えます。線源点→検出器の直線を FreeCAD 側で
+追跡し、通過した材質と厚さを `.paths` ファイルで POKER に渡します。
+
+```bash
+poker_cui model.yaml -p -t                            # 分割点を出力
+freecadcmd -c "... gen_paths.main('spec.json')"       # CAD をトレース
+poker_cui model.yaml --path-input model.paths -t      # 計算
+```
+
+POKER 側の `--path-input` も実装され、CSG 経由と一致することを平板・円筒・球の
+5 体系で確認済みです。フィレットや自由曲面のように CSG で表現できない形状も
+扱えます。**複数線源・グリッド検出器・スラント補正に対応**。
+
+他の CAD で作ったモデルも、STEP で FreeCAD に読み込めば同じパイプラインに
+乗ります。副産物として、POKER の改造なしで使える**簡易化の監査ツール**
+（ある形状を省略してよいかを定量化する）もあります。
+
+詳細は [CAD_RAYTRACE.md](./docs/manuals/CAD_RAYTRACE.md)、フォーマットは
+[PATHS_FORMAT.md](./docs/manuals/PATHS_FORMAT.md)。
+
+詳細は [CHANGELOG.md](./CHANGELOG.md) を参照。
+
 ## 🆕 バージョン1.5.0の新機能
 
 ### 🖥️ POKER GUI を閉じずに表示を切り替え
@@ -33,8 +116,6 @@ YAML-based input file management tool for radiation-shielding calculation code P
 乱数で「正常」を出力する監視スクリプトなど、実態と乖離した記述を削除し、
 検証可能な手順のみに整理しています。
 
-詳細は [CHANGELOG.md](./CHANGELOG.md) を参照。
-
 ## 🆕 バージョン1.4.0の新機能
 
 ### ☢️ 子孫核種の自動管理
@@ -255,7 +336,7 @@ Claude Desktopで以下のようにテストできます：
 ## 🏆 主要機能
 
 ### ✅ **MCP完全対応**
-- **30メソッド完全実装**: 全ての放射線遮蔽計算入力管理機能
+- **33メソッド完全実装**: 全ての放射線遮蔽計算入力管理機能
 - **JSON-RPC 2.0準拠**: 標準プロトコル完全対応
 - **STDIO通信**: MCPクライアントとの標準通信方式
 - **自動バックアップ・ロールバック**: 企業品質のデータ保護
@@ -274,7 +355,7 @@ Claude Desktopで以下のようにテストできます：
 
 ## 🎯 API構成
 
-### 🔧 **30メソッド完全実装**
+### 🔧 **33メソッド完全実装**
 
 | **カテゴリ** | **メソッド数** | **機能** | **主要操作** |
 |-------------|---------------|----------|-------------|
@@ -287,7 +368,7 @@ Claude Desktopで以下のようにテストできます：
 | **📏 Unit** | 5個 | 単位設定管理 | propose・get・update・validateIntegrity・analyzeConversion |
 | **⚙️ System** | 6個 | システム制御 | applyChanges・executeCalculation・resetYaml・confirmDaughterNuclides・openGui・各種検証 |
 
-### 📋 **全30メソッド一覧**
+### 📋 **全33メソッド一覧**
 ```
 Body系 (3):          poker_proposeBody, poker_updateBody, poker_deleteBody
 Zone系 (3):          poker_proposeZone, poker_updateZone, poker_deleteZone  

package/package.json

@@ -1,55 +1,56 @@
-{
-  "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.7.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/",
+    "README.md",
+    ".mcp.json"
+  ]
+}

package/src/mcp/handlers/index.js

@@ -5,7 +5,8 @@ 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 { createCalculationHandlers } from './calculationHandlers.js';
 import { resetHandlers } from './resetHandlers.js';
 import { createDaughterNuclideHandler } from './daughterNuclideHandler.js';
@@ -32,7 +33,8 @@ export function createAllHandlers(taskManager) {
     ...createDetectorHandlers(taskManager),
     
     // 単位操作
-    ...createUnitHandlers(taskManager),
+    ...createUnitHandlers(taskManager),
+    ...createThinnedIndicesHandlers(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']

package/src/mcp/tools/index.js

@@ -6,7 +6,8 @@ import { buildupFactorTools } from './buildupFactorTools.js';
 import { sourceTools } from './sourceTools.js';
 import { detectorTools } from './detectorTools.js';
 import { commonTools } from './commonTools.js';
-import { unitTools } from './unitTools.js';
+import { unitTools } from './unitTools.js';
+import { thinnedIndicesTools } from './thinnedIndicesTools.js';
 import { calculationTools } from './calculationTools.js';
 import { resetTools } from './resetTools.js';
 import { daughterNuclideTools } from './daughterNuclideTools.js';
@@ -20,7 +21,8 @@ export const allTools = [
   ...sourceTools,
   ...detectorTools,
   ...commonTools,
-  ...unitTools,
+  ...unitTools,
+  ...thinnedIndicesTools,
   ...calculationTools,
   ...resetTools,
   ...daughterNuclideTools,
@@ -35,7 +37,8 @@ export {
   sourceTools,
   detectorTools,
   commonTools,
-  unitTools,
+  unitTools,
+  thinnedIndicesTools,
   calculationTools,
   resetTools,
   daughterNuclideTools,

package/src/mcp/tools/resetTools.js

@@ -30,11 +30,7 @@ export const resetTools = [
         },
         atmosphere_material: {
           type: 'string',
-          description: 'ATMOSPHEREゾーンに設定する材料',
-          enum: [
-            'Carbon', 'Concrete', 'Iron', 'Lead', 'Aluminium', 'Copper', 'Tungsten',
-            'Air', 'Water', 'PyrexGlass', 'AcrylicResin', 'Polyethylene', 'Soil', 'VOID'
-          ],
+          description: 'ATMOSPHEREゾーンに設定する材料。lib_material.dat に登録された材料名（カスタム材料を含む）または VOID',
           default: 'VOID'
         },
         atmosphere_density: {

package/src/mcp/tools/thinnedIndicesTools.js

@@ -0,0 +1,78 @@
+// thinnedIndicesTools.js
+//
+// サマリーに書き出す件数を制御する thinnedindices ノードの CRU ツール。
+// D（削除）は用意しない。削除しても POKER 側の既定値に戻るだけで、
+// updateThinnedIndices で既定値を指定すれば同じ結果になるため。
+//
+// 既定値（ノードまたはキーを省略した場合に POKER が使う値）:
+//   sourcepoint 10 / pseudosourcepoint 10 / detectorgrid 10 /
+//   detectorevaluation 5 / pathtrace 5 / buildupenergy 3 / buildupmfp 3
+//
+// これらは poker_mcp 側では持たない。省略しても .summary には全 7 キーが
+// 値付きで出力されるので、実際の適用値はそちらを見れば分かる。既定値を
+// 複製すると POKER 側の変更に追随できず、静かに食い違う。
+
+const KEY_DESC = {
+  sourcepoint: '入力パラメータに書き出す線源分割点の数',
+  pseudosourcepoint: '入力パラメータに書き出す仮想点線源の数',
+  detectorgrid: '入力パラメータに書き出す検出器評価点の数',
+  detectorevaluation: '計算結果に書き出すグリッド検出器の評価点数',
+  pathtrace: 'path_trace に書き出す仮想点線源の数',
+  buildupenergy: '多層ビルドアップ係数のエネルギー数',
+  buildupmfp: '各エネルギーに対する mfp 数'
+};
+
+const keyProps = (prefix) => {
+  const p = {};
+  for (const [k, d] of Object.entries(KEY_DESC)) {
+    p[k] = {
+      type: 'integer',
+      minimum: 1,
+      description: `${prefix}${d}`
+    };
+  }
+  return p;
+};
+
+export const thinnedIndicesTools = [
+  {
+    name: 'poker_proposeThinnedIndices',
+    description: 'サマリー出力量の設定（thinnedindices）を新規作成します。既に存在する場合は updateThinnedIndices を使ってください。全キー省略可で、省略したキーは POKER の既定値が使われます。',
+    inputSchema: {
+      type: 'object',
+      properties: keyProps(''),
+      required: [],
+      additionalProperties: false,
+      title: 'サマリー出力量の設定',
+      description: '指定したキーのみ書き出します。省略したキーは POKER の既定値（sourcepoint 10 / pseudosourcepoint 10 / detectorgrid 10 / detectorevaluation 5 / pathtrace 5 / buildupenergy 3 / buildupmfp 3）が適用されます。'
+    }
+  },
+  {
+    name: 'poker_getThinnedIndices',
+    description: 'サマリー出力量の設定を取得します。YAML に書かれているキーのみ返し、省略されているキーは既定値が使われることを示します。実際の適用値は計算後の .summary の「サマリに出力される情報量」セクションで確認できます。',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      required: [],
+      additionalProperties: false
+    }
+  },
+  {
+    name: 'poker_updateThinnedIndices',
+    description: 'サマリー出力量の設定を更新します（部分更新可能）。ノードが無い場合は新規作成します。fit_for_paths を指定すると、入力の線源分割数と検出器評価点数から必要な値を自動で設定します（.paths 生成で全点が必要なとき）。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ...keyProps('新しい'),
+        fit_for_paths: {
+          type: 'boolean',
+          description: 'true にすると、入力の線源分割定義（r×φ×z 等）と検出器のグリッド定義から必要数を計算し、sourcepoint / detectorgrid / detectorevaluation をその値に設定します。.paths の生成には全ての線源分割点と評価点が必要なため。個別に指定したキーがあればそちらを優先します。'
+        }
+      },
+      required: [],
+      additionalProperties: false,
+      title: 'サマリー出力量の部分更新',
+      description: '指定したキーのみ変更します。省略したキーは現在の設定を維持します。'
+    }
+  }
+];

package/src/services/DataManager.js

@@ -473,6 +473,13 @@ export class SafeDataManager {
             if ('use_finite_medium_correction' in data) {
               buildup.use_finite_medium_correction = data.use_finite_medium_correction;
             }
+            if ('equivalent' in data) {
+              if (data.equivalent === '' || data.equivalent === null) {
+                delete buildup.equivalent;
+              } else {
+                buildup.equivalent = data.equivalent;
+              }
+            }
           }
         }
         break;
@@ -646,12 +653,41 @@ export class SafeDataManager {
         await this.applyUpdateUnit(data);
         break;
 
+      case 'proposeThinnedIndices':
+        await this.applyProposeThinnedIndices(data);
+        break;
+
+      case 'updateThinnedIndices':
+        await this.applyUpdateThinnedIndices(data);
+        break;
+
       default:
         logger.warn('未知の変更アクション', { action });
         break;
     }
   }
 
+  //|
+  //| thinnedindices — サマリーに書き出す件数の制御
+  //|   省略したキーは POKER の既定値が使われる。既定値は持たない
+  //|   （.summary に全 7 キーが出力されるので、そちらを正とする）。
+  //|
+  async applyProposeThinnedIndices(data) {
+    if (this.data.thinnedindices) {
+      throw new DataError('thinnedindices セクションは既に存在します',
+        'THINNEDINDICES_ALREADY_EXISTS');
+    }
+    this.data.thinnedindices = { ...data };
+    logger.info('thinnedindices を作成しました', { data });
+  }
+
+  async applyUpdateThinnedIndices(data) {
+    // 無ければ作る（update で新規作成も許す。削除ツールが無いので、
+    // 既定値に戻したい場合もこのメソッドを通る）
+    this.data.thinnedindices = { ...(this.data.thinnedindices || {}), ...data };
+    logger.info('thinnedindices を更新しました', { data: this.data.thinnedindices });
+  }
+
   // Unit専用処理メソッド
   async applyProposeUnit(data) {
     try {