poker MCP

扑克MCP服务器 🚀

基于YAML的输入文件管理工具，用于辐射屏蔽计算代码POKER，全面支持MCP

📋 快速信息

• 版本1.2.5（增强版发布）
• 协议完全符合MCP（模型上下文协议）1.0.0标准
• 主服务器： src/mcp_server_stdio_v4.js
• 数据保存tasks/目录（运行时自动创建）
• 执行方式STDIO通信（MCP协议标准）

🆕 版本1.2.5的新功能

⚡ 冲突检测系统

• 实时干涉检查自动检测立体间的重叠和接触
• 自动修正建议提出解决冲突的几何调整方案
• 物理可行性验证事先防止非物理配置

☢️ 子孙核种自动管理

• ICRP-07数据库整合内置1,254种核素的衰变数据
• 辐射平衡计算自动计算从亲核素到子核素
• 贡献度阈值控制自动添加贡献度5%以上的核素

📏 单位制完整性保证

• 四键完整性验证长度、角度、密度、放射性的连续性保证
• 单位换算分析自动计算不同单位系统间的转换系数
• 物理完整性检查验证单位组合的合理性

🔄 YAML重置功能

• 三级重置级别最小、标准、完整
• 自动备份重置前请务必创建备份
• 保护氛围必须区域的自动恢复

🔧 检测器分析功能

• 兼容性检查分析多个探测器之间的可比性
• 性能优化建议内存使用量与计算效率的优化
• 系统整体分析对全部探测器的综合性能评估

⚡ 设置

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

1. 添加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"
         }
       }
     }
   }

1. 使用NPX时

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

1. 重启Claude Desktop 并启用MCP服务器

注意：

• env（作为）章节的POKER_INSTALL_PATH是可选项（省略时C:/Poker（使用）
• 通过环境变量指定的路径lib/ICRP-07.NDX文件在首次启动时data/将被复制到

4. 动作确认

您可以在Claude Desktop上进行如下测试：

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

📚 文档

📖（书本） 详细README文件 - 详细信息·API·使用示例

📚 书籍或学习的象征 手册 - 所含手册集

🎓（毕业帽表情，通常表示毕业、庆祝或学业成就） 互动指南 - 三阶段学习系统

🏆 主要功能

✅ 完全兼容MCP

• 29个方法的完全实现所有辐射屏蔽计算输入管理功能
• 符合JSON-RPC 2.0标准完全支持标准协议
• STDIO通信与MCP客户端的标准通信方式
• 自动备份与回滚企业级数据保护

✅ 专为辐射屏蔽计算设计

• 10种立体形状SPH（球体）、RCC（矩形柱体）、RPP（长方体）、BOX（盒子，与RPP含义相近，但常用于特定上下文）、CMB（圆柱体，可能指圆柱形物体）、TOR（圆环或圆锥台，具体含义依上下文而定）、ELL（椭球体）、REC（矩形，与RCC中的“矩形”概念相似但更通用）、TRC（三角柱或三角形区域，具体含义依上下文而定）、WED（楔形体）
• 14种材料混凝土、铅、铁、VOID等标准屏蔽材料
• 支持多线源点、体积线源的全面管理
• 探测器布置灵活配置0D/1D/2D/3D探测器

✅ 物理验证系统

• 冲突检测实时立体干涉检查
• 子代核素管理ICRP-07数据库标准的自动计算
• 单位一致性4键完整性保证系统
• 材料适当性密度和物性的自动验证

🎯 API配置

🔧 修理工具或扳手的符号，常用于表示需要修理或维护的物品或情境。 29种方法完全实现

| 5个 | 系统控制 | applyChanges·executeCalculation·resetYaml·confirmDaughterNuclides·各种验证 | 📋 代表“清单”或“待办事项”的意思。

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, 内部検証メソッド群

全部29个方法一览

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_resetYaml→

执行方法（最小级别）

「遮蔽計算を実行して、線量分布結果を取得してください」

扑克牌计算执行 poker_executeCalculation→

方法自动执行

「作成したモデルを保存してください」

保存更改 poker_applyChanges→

方法自动执行

🌟 质量声明

• ✅ 完全符合MCP协议JSON-RPC 2.0
• 全面实现，错误处理完备STDIO通信
• 基于标准输入输出的高速通信型安全性（此处“型”可能指“类型”或“型号”，具体需根据上下文确定，若直接翻译则为“类型安全性”或“型号安全性”，但在此保持原样以保留原文含义）
• Zod Schema严格验证企业级品质

99.97%的可用性记录

• ✅ 专门进行辐射屏蔽计算物理合理性
• 全参数的物理验证材料数据库
• 标准遮蔽材料14种齐全单位系统管理
• 四要素完整性保证（长度·角度·密度·放射性）计算质量保证

自动一致性检查

• ✅ 注重实用性设计自动备份
• 全程自动数据保护（最多10代）依赖关系检查
• 安全删除和更新处理错误恢复
• 具备回滚功能响应速度

\<50毫秒响应时间

• ✅ 增强错误处理（v1.2.5）自动判别propose/update
• 根据错误信息提供的适当方法指南专用错误代码
• 各操作特有的错误代码体系材料名建议
• 类似材料名称的自动建议功能Transform参照验证

依赖关系的预先检查

• 📊 对应的计算代码扑克
• 辐射屏蔽计算主程序扑克_崔（注：这里的“poker_cui”可能是一个用户名或特定语境下的标识，根据中文表达习惯，将其翻译为“扑克_崔”，其中“崔”是根据英文发音“Cui”音译得出的中文姓氏，具体翻译可能需根据实际语境调整。）

命令行执行界面

• 🔗 系统要求Node.js
• ≥18.0.0操作系统（OS）
• Windows、macOS、LinuxMCP 客户端
• Claude Desktop（推荐）、其他MCP客户端内存

建议512MB以上（使用大型检测器时建议1GB以上）

🎯 实际使用工作流程

1. 典型的研究工作流程

   「医療施設のCT室遮蔽設計をしたいので、2m×3m×30cmのコンクリート壁を作成してください」

1. 在Claude Desktop中使用自然语言指令

- 自动执行MCP方法

1. 三维建模→碰撞检测→材料设定→线源布置→子核素确认→探测器设定

   「遮蔽効果を計算して、規制値との比較結果を教えてください」

1. 执行计算并获取结果

- 结果的物理解释 - 剂量分布的分析 - 遮蔽效果的定量评估

法规符合性确认

📝 更新日志

• 版本1.2.5（2025年1月24日）
• ✨ 冲突检测系统实施
• ✨增加了子核素自动补全功能（整合ICRP-07）
• ✨ 单位系统完整性验证强化（4键保障）
• ✨ 实现YAML重置功能（3级）
• ✨增加检测器分析功能
• 🐛 统一NuclideManager默认路径
• 📝 .mcp.json文件完整化
• 📝 材料数量从13增加到14（新增VOID标注）

🗑️ 删除archive目录（整理未使用文件）

• v1.1.0（之前版本）
• 基本24种方法的实现
• 符合MCP 1.0.0标准

自动备份功能

• v1.0.0（初始发布）
• 初期发布

YAML管理基本功能

• 📞 支持与详细信息📖 详细README ：
• docs/README.md（文件说明/读我文件）📚 完全手册 ：
• 文档/手册/🎓 互动指南 ：
• docs/interactive_guides/ 翻译为中文是：文档/交互式指南/📋 政治纲领 ：
• config/mcp-manifest.json 翻译为中文是：“配置/MCP清单文件.json”🐛 问题 ：

______________________________________________________________________

GitHub Issues（GitHub问题）\ 🎯 Poker MCP 服务器 v1.2.5协议\ 完全符合MCP 1.0.0作者 平尾洋弘许可证