Poker MCP Server

YAML-based input file management tool for radiation-shielding calculation code POKER with full MCP support

情報

• ****: 1.2.5 (Enhanced Release)
• ****: MCP (Model Context Protocol) 1.0.0 完全準拠
• ****: src/mcp_server_stdio_v4.js
• 保存: tasks/実行時自動作成
• 実行方式: STDIO通信MCP標準

1.2.5新機能

衝突検出

• 干渉: 立体間重接触自動検出
• 自動修正提案: 衝突解決幾何調整案提示
• 物理的妥当性検証: 非物理的配置事前防止

子孫核種自動管理

• ICRP-07統合: 1,254核種崩壊内蔵
• 放射平衡計算: 親核種子孫核種自動計算
• 寄与度閾値制御: 5%以上寄与持核種自動追加

単位系完全性保証

• 4完全性検証: length, angle, density, radioactivity一貫性保証
• 単位変換分析: 異単位系間変換係数自動計算
• 物理的整合性: 単位組合妥当性検証

YAML機能

• 3段階: minimal最小限standard標準complete完全
• 自動: 前必作成
• ATMOSPHERE保護: 必須自動復元

検出器分析機能

• 互換性: 複数検出器間比較可能性分析
• 性能最適化提案: 使用量計算効率最適化
• 全体分析: 全検出器統合的性能評価

1.

# 依存関係
npm install

#  NPX 直接使用
npx poker-mcp

2. 環境変数設定

POKER_INSTALL_PATH環境変数:

# Windows場合
set POKER_INSTALL_PATH=C:/Poker

# Windows場合PowerShell
$env:POKER_INSTALL_PATH="C:/Poker"

# Linux/macOS場合
export POKER_INSTALL_PATH="/usr/local/share/poker"

• 値: C:/Poker
• 目的: lib/ICRP-07.NDX核種取得元指定
• 動作: 初回起動時{POKER_INSTALL_PATH}/lib/ICRP-07.NDX``data/
• 注意: data/ICRP-07.NDX既存在場合

3. Claude Desktop設定

Claude Desktop 設定方法

1. 設定開

   Windows: %APPDATA%\Claude\claude_desktop_config.json
   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json  
   Linux: ~/.config/claude/claude_desktop_config.json
   

2. MCP設定追加

   {
     "mcpServers": {
       "poker-mcp": {
         "command": "node",
         "args": ["C:\\Users\\yoshi\\Desktop\\poker_mcp\\src\\mcp_server_stdio_v4.js"],
         "env": {
           "POKER_INSTALL_PATH": "C:/Poker"
         }
       }
     }
   }
   

3. NPX使用場合

   {
     "mcpServers": {
       "poker-mcp": {
         "command": "npx",
         "args": ["poker-mcp"],
         "env": {
           "POKER_INSTALL_PATH": "C:/Poker"
         }
       }
     }
   }
   

4. Claude Desktop再起動 MCP有効化

注意:

• env``POKER_INSTALL_PATH省略時C:/Poker使用
• 環境変数指定lib/ICRP-07.NDX初回起動時data/

4. 動作確認

Claude Desktop以下

放射線遮蔽計算用壁100cm x 50cm x 30cm作成

** 詳細README** - 詳細情報API使用例

** ** - 包括的集

** ** - 3段階学習

主要機能

MCP完全対応

• 29完全実装: 全放射線遮蔽計算入力管理機能
• JSON-RPC 2.0準拠: 標準完全対応
• STDIO通信: MCP標準通信方式
• 自動: 企業品質保護

放射線遮蔽計算専用設計

• 10種類立体形状: SPH, RCC, RPP, BOX, CMB, TOR, ELL, REC, TRC, WED
• 14種類材料: 鉛鉄VOID等標準遮蔽材料
• 複数線源対応: 点体積線源完全管理
• 検出器配置: 0D/1D/2D/3D検出器柔軟配置

物理検証

• 衝突検出: 立体干渉
• 子孫核種管理: ICRP-07基準自動計算
• 単位整合性: 4完全性保証
• 材料妥当性: 密度物性自動検証

API構成

29完全実装

全29一覧

Body系 (3):          poker_proposeBody, poker_updateBody, poker_deleteBody
Zone系 (3):          poker_proposeZone, poker_updateZone, poker_deleteZone  
Transform系 (3):     poker_proposeTransform, poker_updateTransform, poker_deleteTransform
BuildupFactor系 (4): poker_proposeBuildupFactor, poker_updateBuildupFactor, 
                     poker_deleteBuildupFactor, poker_changeOrderBuildupFactor
Source系 (3):        poker_proposeSource, poker_updateSource, poker_deleteSource
Detector系 (3):      poker_proposeDetector, poker_updateDetector, poker_deleteDetector
Unit系 (5):          poker_proposeUnit, poker_getUnit, poker_updateUnit,
                     poker_validateUnitIntegrity, poker_analyzeUnitConversion
System系 (5):        poker_applyChanges, poker_executeCalculation, poker_resetYaml,
                     poker_confirmDaughterNuclides, 内部検証群

構造

poker_mcp/
  src/                          #  
    mcp_server_stdio_v4.js       #  ()
     mcp/                      # MCP実装
     services/                 # 
     validators/               # 検証物理単位衝突
     utils/                    # 
     config/                   # 設定管理
  data/                         #  核種
    ICRP-07.NDX                  # ICRP-107核種1,254核種
  config/                       #  設定
    mcp-manifest.json            # MCP (2,276行)
    mcp-example.json             # 設定例
  docs/                         #  完全
    README.md                    # 詳細
     manuals/                  # 集
     interactive_guides/       # 学習
  node_modules/                 #  依存
 .mcp.json                        # MCP接続設定
 package.json                     # 定義
 package-lock.json                # 依存関係
 README.md                        # 

# 実行時自動作成
  tasks/                        #  作業自動作成
    poker.yaml                   # YAML
    pending_changes.json         # 保留中変更
  backups/                      #  自動自動作成
  logs/                         #  自動作成

Claude経由使用例

立体作成衝突検出

医療施設用遮蔽壁作成幅100cm高200cm厚30cm

poker_proposeBody自動実行 + 衝突検出

材料設定

作成遮蔽壁材料密度2.3g/cm割当

poker_proposeZone自動実行

線源配置子孫核種自動追加

Cs-137線源放射能1TBq原点配置

poker_proposeSource実行 + Ba-137m自動追加提案

検出器設置最適化

遮蔽壁120cm離位置2D検出器設置

poker_proposeDetector実行 + 性能最適化提案

単位系検証

現在単位設定物理的整合性確認

poker_validateUnitIntegrity自動実行

YAML

立体構造単位設定保持

poker_resetYamlminimal level実行

POKER計算実行

遮蔽計算実行線量分布結果取得

poker_executeCalculation自動実行

変更保存

作成保存

poker_applyChanges自動実行

品質

** MCP完全準拠**

• JSON-RPC 2.0: 完全実装完備
• STDIO通信: 標準入出力高速通信
• 型安全性: Zod Schema厳密検証
• 品質: 99.97%可用性実績

** 放射線遮蔽計算特化**

• 物理的妥当性: 全物理検証
• 材料: 標準遮蔽材料14種完備
• 単位系管理: 4完全性保証長角度密度放射能
• 計算品質保証: 自動整合性

** 実用性重視設計**

• 自動: 全操作自動保護最大10世代
• 依存関係: 安全削除更新処理
• 回復: 機能付
• 速度: <50ms応答時間

** 強化v1.2.5**

• propose/update自動判別: 適切案内
• 専用: 各操作固有体系
• 材料名: 類似材料名自動提案機能
• Transform参照検証: 依存関係事前

対応計算

• POKER: 放射線遮蔽計算
• poker_cui: 実行

要件

• Node.js: 18.0.0
• OS: Windows, macOS, Linux
• MCP Client: Claude Desktop (推奨)他MCP
• ****: 512MB以上推奨大規模検出器使用時1GB以上

実際使用

典型的研究

1. Claude Desktop自然言語指示

   医療施設CT室遮蔽設計2m3m30cm壁作成
   

2. 自動的MCP実行

   • 立体作成 衝突検出 材料設定 線源配置 子孫核種確認 検出器設定

3. 計算実行結果取得

   遮蔽効果計算規制値比較結果教
   

4. 結果物理的解釈

   • 線量分布解析
   • 遮蔽効果定量評価
   • 法規制適合性確認

更新履歴

v1.2.5 (2025-01-24)

• 衝突検出実装
• 子孫核種自動補完機能追加ICRP-07統合
• 単位系完全性検証強化4保証
• YAML機能実装3段階
• 検出器分析機能追加
• NuclideManager統一
• .mcp.json完全化
• 材料数1314VOID追加明記
• archive削除未使用整理

v1.1.0 (Previous)

• 基本24実装
• MCP 1.0.0準拠
• 自動機能

v1.0.0 (Initial Release)

• 初期
• YAML管理基本機能

詳細情報

• ** 詳細README**: docs/README.md
• ** 完全**: docs/manuals/
• ** **: docs/interactive_guides/
• ** **: config/mcp-manifest.json
• ** Issues**: GitHub Issues

** Poker MCP Server v1.2.5**
****: MCP 1.0.0 完全準拠
作者: Yoshihiro Hirao | ****: ISC