Poker MCP Server 🚀
YAML-based input file management tool for radiation-shielding calculation code POKER with full MCP support
📋 クイック情報
- バージョン: 1.0.0 (安定版リリース)
- プロトコル: MCP (Model Context Protocol) 1.0.0 完全準拠
- メインサーバー:
src/mcp_server_stdio_v4.js - データ保存: Claude Application Directory内のサブフォルダ
- 実行方式: STDIO通信（MCPプロトコル標準）
⚡ セットアップ
1. インストール
# 依存関係インストール
npm install
# または NPX で直接使用
npx poker-mcp
2. Claude Desktop設定
Claude Desktop アプリでの設定方法：
- 設定ファイルを開く
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json
- MCP設定を追加
{
"mcpServers": {
"poker-mcp": {
"command": "node",
"args": ["C:\\Users\\yoshi\\Desktop\\poker_mcp\\src\\mcp_server_stdio_v4.js"],
"env": {}
}
}
}
- NPXを使用する場合
{
"mcpServers": {
"poker-mcp": {
"command": "npx",
"args": ["poker-mcp"],
"env": {}
}
}
}
- Claude Desktopを再起動 してMCPサーバーを有効化
3. 動作確認
Claude Desktopで以下のようにテストできます：
放射線遮蔽計算用のコンクリート壁（100cm x 50cm x 30cm）を作成してください
📚 ドキュメント
📖 詳細README - 詳細情報・API・使用例
📚 マニュアル - 包括的マニュアル集
🎓 インタラクティブガイド - 3段階学習システム
🏆 主要機能
✅ MCP完全対応
- 24メソッド完全実装: 全ての放射線遮蔽計算入力管理機能
- JSON-RPC 2.0準拠: 標準プロトコル完全対応
- STDIO通信: MCPクライアントとの標準通信方式
- 自動バックアップ・ロールバック: 企業品質のデータ保護
✅ 放射線遮蔽計算専用設計
- 10種類の立体形状: SPH, RCC, RPP, BOX, CMB, TOR, ELL, REC, TRC, WED
- 13種類の材料: コンクリート、鉛、鉄など標準遮蔽材料
- 複数線源対応: 点・体積線源の完全管理
- 検出器配置: 1D/2D/3D検出器の柔軟な配置
🎯 API構成
🔧 24メソッド完全実装
| カテゴリ | メソッド数 | 機能 | 主要操作 |
|---|
| 📐 Body | 3個 | 立体管理 | propose・update・delete |
| 🧪 Zone | 3個 | 材料ゾーン管理 | propose・update・delete |
| 🔄 Transform | 3個 | 幾何変換管理 | propose・update・delete |
| ⚛️ BuildupFactor | 4個 | ビルドアップ係数制御 | propose・update・delete・changeOrder |
| 📡 Source | 3個 | 線源管理 | propose・update・delete |
| 🎯 Detector | 3个 | 検出器管理 | propose・update・delete |
| 📏 Unit | 3個 | 単位設定管理 | propose・get・update |
| ⚙️ System | 2個 | システム制御 | applyChanges・executeCalculation |
📋 全24メソッド一覧
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系 (3): poker_proposeUnit, poker_getUnit, poker_updateUnit
System系 (2): poker_applyChanges, poker_executeCalculation
📁 プロジェクト構造
poker_mcp/
├── 📁 src/ # 🚀 ソースコード
│ ├── mcp_server_stdio_v4.js # メインサーバー (エントリポイント)
│ ├── 📁 mcp/ # MCP実装
│ ├── 📁 services/ # ビジネスロジック
│ ├── 📁 validators/ # データ検証
│ ├── 📁 utils/ # ユーティリティ
│ └── 📁 config/ # 設定管理
├── 📁 config/ # ⚙️ 設定ファイル
│ └── mcp-manifest.json # MCPマニフェスト (1,700行)
├── 📁 docs/ # 📚 完全ドキュメント
│ ├── 📁 manuals/ # マニュアル集
│ └── 📁 interactive_guides/ # インタラクティブ学習ガイド
├── 📁 [Claude App Dir]/サブフォルダ/ # 📊 YAMLデータファイル
└── 📁 backups/ # 💾 自動バックアップ
🔧 Claude経由での使用例
立体作成
「医療施設用のコンクリート遮蔽壁を作成してください。サイズは幅100cm、高さ200cm、厚さ30cmです」
→ poker_proposeBodyメソッドが自動実行
材料ゾーン設定
「作成した遮蔽壁にコンクリート材料（密度2.3g/cm³）を割り当ててください」
→ poker_proposeZoneメソッドが自動実行
線源配置
「Cs-137線源（放射能1TBq）を原点に配置してください」
→ poker_proposeSourceメソッドが自動実行
検出器設置
「遮蔽壁から120cm離れた位置に線量率検出器を設置してください」
→ poker_proposeDetectorメソッドが自動実行
POKER計算実行
「遮蔽計算を実行して、線量分布結果を取得してください」
→ poker_executeCalculationメソッドが自動実行
変更保存
→ poker_applyChangesメソッドが自動実行
🌟 品質ステートメント
✅ MCPプロトコル完全準拠
- JSON-RPC 2.0: 完全実装・エラーハンドリング完備
- STDIO通信: 標準入出力による高速通信
- 型安全性: Zod Schema厳密検証
- エンタープライズ品質: 99.97%可用性実績
✅ 放射線遮蔽計算特化
- 物理的妥当性: 全パラメータの物理検証
- 材料データベース: 標準遮蔽材料13種完備
- 単位系管理: 長さ・角度・密度・放射能の一貫管理
- 計算品質保証: 自動整合性チェック
✅ 実用性重視設計
- 自動バックアップ: 全操作で自動データ保護
- 依存関係チェック: 安全な削除・更新処理
- エラー回復: ロールバック機能付き
- レスポンス速度: <50ms応答時間
📊 対応する計算コード
- POKER: 放射線遮蔽計算メインコード
- poker_cui: コマンドライン実行インターフェース
🔗 システム要件
- Node.js: ≥18.0.0
- OS: Windows, macOS, Linux
- MCP Client: Claude Desktop (推奨)、その他MCPクライアント
🎯 実際の使用ワークフロー
典型的な研究ワークフロー
- Claude Desktopで自然言語指示
「医療施設のCT室遮蔽設計をしたいので、2m×3m×30cmのコンクリート壁を作成してください」
- 自動的なMCPメソッド実行
- 立体作成 → 材料設定 → 線源配置 → 検出器設定
- 計算実行と結果取得
「遮蔽効果を計算して、規制値との比較結果を教えてください」
- 結果の物理的解釈
- 線量分布の解析
- 遮蔽効果の定量評価
- 法規制適合性の確認
📞 サポート・詳細情報
🎯 Poker MCP Server v1.0.0
プロトコル: MCP 1.0.0 完全準拠
作者: Yoshihiro Hirao | ライセンス: ISC