poker-mcp 1.2.7 → 1.2.8

package/README.md

@@ -4,12 +4,22 @@ YAML-based input file management tool for radiation-shielding calculation code P
 
 ## 📋 クイック情報
 
-- **バージョン**: 1.2.7
+- **バージョン**: 1.2.8
 - **プロトコル**: MCP (Model Context Protocol) 1.0.0 完全準拠
 - **メインサーバー**: `src/mcp_server_stdio_v4.js`
 - **データ保存**: `~/.poker-mcp/`（`POKER_MCP_HOME`環境変数で変更可）
 - **実行方式**: STDIO通信（MCPプロトコル標準）
 
+## 🆕 バージョン1.2.8の新機能
+
+### ✨ `poker_openGui` — POKER GUI 起動メソッドを追加
+作成した入力ファイルを POKER.exe でビジュアル確認できます。
+
+- 保留中の変更を **自動保存してから** POKER.exe を起動
+- `yaml_file` は省略可（デフォルト: `poker.yaml`）
+- `POKER_INSTALL_PATH/POKER.exe`（デフォルト: `C:/Poker/POKER.exe`）を使用
+- Windows 専用
+
 ## 🆕 バージョン1.2.7の修正（バグフィックス）
 
 ### 🐛 `poker_executeCalculation` の yaml_file パス解決を修正
@@ -345,6 +355,11 @@ POKER_MCP_HOME/
 
 ## 📝 更新履歴
 
+### v1.2.8 (2026-05-16)
+- ✨ `poker_openGui` メソッドを新設（POKER.exe でGUI確認）
+- ✨ 起動前に `applyChanges` を自動実行
+- ✨ `yaml_file` 省略可（デフォルト: `poker.yaml`）、`POKER_INSTALL_PATH` 環境変数使用
+
 ### v1.2.7 (2026-05-16)
 - 🐛 `poker_executeCalculation` の `yaml_file` パス解決バグを修正（スキーマ・ハンドラー間の矛盾）
 - ✨ ファイル名のみの指定で `POKER_MCP_HOME/tasks/` 配下を自動参照
@@ -385,6 +400,6 @@ POKER_MCP_HOME/
 
 ---
 
-**🎯 Poker MCP Server v1.2.7**  
+**🎯 Poker MCP Server v1.2.8**  
 **プロトコル**: MCP 1.0.0 完全準拠  
 **作者**: Yoshihiro Hirao | **ライセンス**: ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poker-mcp",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "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",

package/src/mcp/handlers/guiHandlers.js

@@ -0,0 +1,124 @@
+// mcp/handlers/guiHandlers.js
+import { spawn } from 'child_process';
+import { promises as fs } from 'fs';
+import path from 'path';
+import { logger } from '../../utils/logger.js';
+import { TASKS_DIR, YAML_FILE } from '../../utils/paths.js';
+
+/**
+ * POKER.exe のパスを解決する
+ * POKER_INSTALL_PATH 環境変数（デフォルト: C:/Poker）配下の POKER.exe を参照
+ */
+function resolvePokerExePath() {
+  const installPath = process.env.POKER_INSTALL_PATH || 'C:/Poker';
+  return path.win32.join(installPath.replace(/\//g, '\\'), 'POKER.exe');
+}
+
+/**
+ * yaml_file 引数を絶対パスに解決する
+ * ファイル名のみ → TASKS_DIR と結合
+ * 絶対パス      → そのまま使用（後方互換）
+ */
+function resolveYamlPath(yamlFile) {
+  const absolutePathPattern = /^([a-zA-Z]:[\\\/]|\/)/;
+  return absolutePathPattern.test(yamlFile)
+    ? yamlFile
+    : path.join(TASKS_DIR, yamlFile);
+}
+
+export function createGuiHandlers(taskManager) {
+  return {
+    async openGui(args) {
+      const yamlFile      = args?.yaml_file || 'poker.yaml';
+      const resolvedYaml  = resolveYamlPath(yamlFile);
+      const pokerExePath  = resolvePokerExePath();
+
+      logger.info('poker_openGui: 開始', {
+        input:      yamlFile,
+        resolvedYaml,
+        pokerExePath
+      });
+
+      // ── Step 1: applyChanges を自動実行 ──────────────────────────
+      let applyResult;
+      try {
+        applyResult = await taskManager.applyChanges();
+        logger.info('poker_openGui: applyChanges 完了', { result: applyResult });
+      } catch (applyError) {
+        logger.error('poker_openGui: applyChanges 失敗', { error: applyError.message });
+        return {
+          success: false,
+          error:      `変更の保存に失敗しました: ${applyError.message}`,
+          error_type: 'APPLY_CHANGES_FAILED',
+          suggestion: 'poker_applyChanges を手動で実行してエラー内容を確認してください。'
+        };
+      }
+
+      // ── Step 2: POKER.exe の存在確認 ─────────────────────────────
+      try {
+        await fs.access(pokerExePath);
+      } catch {
+        logger.error('poker_openGui: POKER.exe が見つかりません', { pokerExePath });
+        return {
+          success:    false,
+          error:      `POKER.exe が見つかりません: ${pokerExePath}`,
+          error_type: 'POKER_EXE_NOT_FOUND',
+          suggestion: 'POKER_INSTALL_PATH 環境変数を正しいインストールディレクトリに設定してください。'
+            + '\n例: "POKER_INSTALL_PATH": "C:\\\\Program Files\\\\POKER"'
+        };
+      }
+
+      // ── Step 3: 入力 YAML の存在確認 ─────────────────────────────
+      try {
+        await fs.access(resolvedYaml);
+      } catch {
+        logger.error('poker_openGui: YAML ファイルが見つかりません', { resolvedYaml });
+        return {
+          success:    false,
+          error:      `入力ファイルが見つかりません: ${resolvedYaml}`,
+          error_type: 'YAML_FILE_NOT_FOUND',
+          suggestion: 'poker_applyChanges を先に実行してください。'
+        };
+      }
+
+      // ── Step 4: POKER.exe をデタッチ起動 ─────────────────────────
+      try {
+        const child = spawn(pokerExePath, [resolvedYaml], {
+          detached: true,
+          stdio:    'ignore',   // MCPサーバーの stdio を汚染しない
+          shell:    false
+        });
+        child.unref();          // MCPサーバーが POKER.exe の終了を待たない
+
+        logger.info('poker_openGui: POKER.exe 起動成功', {
+          pid:        child.pid,
+          executable: pokerExePath,
+          inputFile:  resolvedYaml
+        });
+
+        return {
+          success: true,
+          message: 'POKER GUI を起動しました。',
+          launched: {
+            executable: pokerExePath,
+            input_file: resolvedYaml,
+            pid:        child.pid
+          },
+          auto_saved: {
+            performed: true,
+            details:   applyResult
+          }
+        };
+
+      } catch (launchError) {
+        logger.error('poker_openGui: POKER.exe 起動失敗', { error: launchError.message });
+        return {
+          success:    false,
+          error:      `POKER.exe の起動に失敗しました: ${launchError.message}`,
+          error_type: 'POKER_LAUNCH_FAILED',
+          suggestion: 'POKER.exe の実行権限および POKER_INSTALL_PATH の設定を確認してください。'
+        };
+      }
+    }
+  };
+}

package/src/mcp/handlers/index.js

@@ -9,6 +9,7 @@ import { createUnitHandlers } from './unitHandlers.js';
 import { createCalculationHandlers } from './calculationHandlers.js';
 import { resetHandlers } from './resetHandlers.js';
 import { createDaughterNuclideHandler } from './daughterNuclideHandler.js';
+import { createGuiHandlers } from './guiHandlers.js';
 
 export function createAllHandlers(taskManager) {
   return {
@@ -41,6 +42,9 @@ export function createAllHandlers(taskManager) {
 
     // リセット操作
     resetYaml: resetHandlers.resetYaml(taskManager),
+
+    // GUI表示操作
+    ...createGuiHandlers(taskManager),
     
     // 共通操作
     async applyChanges(args) {

package/src/mcp/tools/guiTools.js

@@ -0,0 +1,25 @@
+// mcp/tools/guiTools.js
+export const guiTools = [
+  {
+    name: 'poker_openGui',
+    description:
+      'YAMLファイルを保存してから POKER.exe でGUI表示します。'
+      + '未保存の変更は自動的に保存（applyChanges）されてから起動します。'
+      + 'POKER_INSTALL_PATH 環境変数（デフォルト: C:/Poker）の POKER.exe を使用します。'
+      + 'Windows専用です。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        yaml_file: {
+          type: 'string',
+          description:
+            '表示する入力ファイル名（省略時は poker.yaml）。'
+            + 'ファイル名のみ指定すると POKER_MCP_HOME/tasks/ 配下を自動参照します。'
+            + '絶対パスも指定可能です。',
+          pattern: '^([a-zA-Z0-9_\\-\\.]+\\.(yaml|yml)|([a-zA-Z]:[\\\\\/]|\\/)[^\\\\]+\\.(yaml|yml))$'
+        }
+      },
+      additionalProperties: false
+    }
+  }
+];

package/src/mcp/tools/index.js

@@ -10,6 +10,7 @@ import { unitTools } from './unitTools.js';
 import { calculationTools } from './calculationTools.js';
 import { resetTools } from './resetTools.js';
 import { daughterNuclideTools } from './daughterNuclideTools.js';
+import { guiTools } from './guiTools.js';
 
 export const allTools = [
   ...bodyTools,
@@ -22,7 +23,8 @@ export const allTools = [
   ...unitTools,
   ...calculationTools,
   ...resetTools,
-  ...daughterNuclideTools
+  ...daughterNuclideTools,
+  ...guiTools
 ];
 
 export {
@@ -36,5 +38,6 @@ export {
   unitTools,
   calculationTools,
   resetTools,
-  daughterNuclideTools
+  daughterNuclideTools,
+  guiTools
 };