Poker MCP Server 🚀

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

📋 クイック情報

バージョン: 1.1.0 (安定版リリース)
プロトコル: MCP (Model Context Protocol) 1.0.0 完全準拠
メインサーバー: src/mcp_server_stdio_v4.js
実行方式: 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": { "POKER_WORK_DIR": "（作業ディレクトリのパス、例えば）C:\\Users\\Yoshi\\Desktop\\PokerWorks", "POKER_DATA_DIR": "data", "POKER_NUCLIDE_FILE": "ICRP-07.NDX" } } } }
NPXを使用する場合
{ "mcpServers": { "poker-mcp": { "command": "npx", "args": ["poker-mcp"], "env": { "POKER_WORK_DIR": "（作業ディレクトリのパス、例えば）C:\\Users\\Yoshi\\Desktop\\PokerWorks", "POKER_DATA_DIR": "data", "POKER_NUCLIDE_FILE": "ICRP-07.NDX" } } } }
Claude Desktopを再起動 してMCPサーバーを有効化

3. 動作確認

Claude Desktopで以下のようにテストできます：

放射線遮蔽計算用のコンクリート壁（100cm x 50cm x 30cm）を作成してください

📚 ドキュメント

📖 - 詳細情報・API・使用例

📚 - 包括的マニュアル集

🎓 - 3段階学習システム

🏆 主要機能

✅ MCP完全対応

28メソッド完全実装: 全ての放射線遮蔽計算入力管理機能
JSON-RPC 2.0準拠: 標準プロトコル完全対応
STDIO通信: MCPクライアントとの標準通信方式
自動バックアップ・ロールバック: 企業品質のデータ保護

✅ 放射線遮蔽計算専用設計

10種類の立体形状: SPH, RCC, RPP, BOX, CMB, TOR, ELL, REC, TRC, WED
13種類の材料: コンクリート、鉛、鉄など標準遮蔽材料
複数線源対応: 点・体積線源の完全管理
検出器配置: 1D/2D/3D検出器の柔軟な配置

🎯 API構成

🔧 28メソッド完全実装

カテゴリ	メソッド数	機能	主要操作
📐 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	5個	単位設定管理	propose・get・update・validate・analyze
⚙️ System	4個	システム制御	apply・execute・reset・confirm

📋 全28メソッド一覧

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系 (4): poker_applyChanges, poker_executeCalculation, poker_resetYaml, poker_confirmDaughterNuclides

📁 プロジェクト構造

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メソッド実行
- 立体作成 → 材料設定 → 線源配置 → 検出器設定
計算実行と結果取得
「遮蔽効果を計算して、規制値との比較結果を教えてください」
結果の物理的解釈
- 線量分布の解析
- 遮蔽効果の定量評価
- 法規制適合性の確認

📞 サポート・詳細情報

📖 詳細README: docs/README.md
🚀 セットアップガイド: docs/SETUP_GUIDE.md
📚 完全マニュアル: docs/manuals/
🎓 インタラクティブガイド: docs/interactive_guides/

🎯 Poker MCP Server v1.1.0
プロトコル: MCP 1.0.0 完全準拠
作者: Yoshihiro Hirao | ライセンス: ISC

Deploy Server

HTTP connection URL

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

Enables AI assistants to manage tasks through YAML-based storage with subtask suggestions, status updates, and Mermaid Gantt chart generation. Supports hierarchical task structures with attributes like dependencies, milestones, and parallel execution.

Related MCP Servers

DeltaTask MCP Server
brysontang
A
security
A
license
A
quality
Provides API access to a locally-hosted task management system with features for creating, updating, and organizing tasks, including support for urgency levels, effort estimates, subtasks, and bi-directional sync with Obsidian markdown files.
Last updated -
12
9
MIT License
TaskFlow MCP
pinkpixel-dev
A
security
A
license
A
quality
A task management server that helps AI assistants break down user requests into manageable tasks and track their completion with user approval steps.
Last updated -
17
265
22
MIT License
Sunsama MCP Server
robertn702
-
security
A
license
-
quality
Enables AI assistants to manage tasks in Sunsama, including creating tasks, reading daily and backlog tasks, marking tasks complete, and organizing projects through streams.
Last updated -
6
16
MIT License
ClickUp MCP Server
DiversioTeam
A
security
A
license
A
quality
Enables AI assistants to interact with ClickUp's task management API for core project workflows, supporting operations like task creation, updates, search, assignment, and team analytics through natural language.
Last updated -
28
3
MIT License

View all related MCP servers

Poker Task Management MCP