poker-mcp 1.2.0 → 1.2.6

package/.mcp.json

@@ -9,7 +9,8 @@
     "command": "node",
     "args": ["src/mcp_server_stdio_v4.js"],
     "env": {
-      "NODE_ENV": "production"
+      "NODE_ENV": "production",
+      "POKER_INSTALL_PATH": "C:/Poker"
     }
   },
   "capabilities": {
@@ -65,7 +66,25 @@
     "pending_file": "tasks/pending_changes.json",
     "backup_directory": "backups",
     "logs_directory": "logs",
-    "nuclide_database": "data/ICRP-07.NDX"
+    "data_directory": "data",
+    "nuclide_database": {
+      "target_file": "data/ICRP-07.NDX",
+      "source_env_var": "POKER_INSTALL_PATH",
+      "source_relative_path": "lib/ICRP-07.NDX",
+      "default_install_path": "C:/Poker",
+      "skip_if_exists": true,
+      "fallback_behavior": "error_if_missing"
+    }
+  },
+  "environment_variables": {
+    "POKER_INSTALL_PATH": {
+      "description": "POKERインストールディレクトリのパス",
+      "required": false,
+      "default": "C:/Poker",
+      "purpose": "lib/ICRP-07.NDXファイルの取得元ディレクトリ指定",
+      "example_windows": "C:/Program Files/POKER",
+      "example_linux": "/usr/local/share/poker"
+    }
   },
   "documentation": {
     "manifest": "config/mcp-manifest.json",

package/README.md

@@ -4,13 +4,13 @@ YAML-based input file management tool for radiation-shielding calculation code P
 
 ## 📋 クイック情報
 
-- **バージョン**: 1.2.0 (Enhanced Release)
+- **バージョン**: 1.2.5 (Enhanced Release)
 - **プロトコル**: MCP (Model Context Protocol) 1.0.0 完全準拠
 - **メインサーバー**: `src/mcp_server_stdio_v4.js`
 - **データ保存**: tasks/ディレクトリ（実行時自動作成）
 - **実行方式**: STDIO通信（MCPプロトコル標準）
 
-## 🆕 バージョン1.2.0の新機能
+## 🆕 バージョン1.2.5の新機能
 
 ### ⚡ 衝突検出システム
 - **リアルタイム干渉チェック**: 立体間の重なり・接触を自動検出
@@ -48,7 +48,26 @@ npm install
 npx poker-mcp
 ```
 
-### 2. Claude Desktop設定
+### 2. 環境変数設定（オプション）
+
+**POKER_INSTALL_PATH環境変数**（オプション）:
+```bash
+# 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 アプリでの設定方法：**
 
@@ -66,7 +85,9 @@ npx poker-mcp
        "poker-mcp": {
          "command": "node",
          "args": ["C:\\Users\\yoshi\\Desktop\\poker_mcp\\src\\mcp_server_stdio_v4.js"],
-         "env": {}
+         "env": {
+           "POKER_INSTALL_PATH": "C:/Poker"
+         }
        }
      }
    }
@@ -79,7 +100,9 @@ npx poker-mcp
        "poker-mcp": {
          "command": "npx",
          "args": ["poker-mcp"],
-         "env": {}
+         "env": {
+           "POKER_INSTALL_PATH": "C:/Poker"
+         }
        }
      }
    }
@@ -87,7 +110,11 @@ npx poker-mcp
 
 4. **Claude Desktopを再起動** してMCPサーバーを有効化
 
-### 3. 動作確認
+**注意**: 
+- `env`セクションの`POKER_INSTALL_PATH`はオプションです（省略時は`C:/Poker`を使用）
+- 環境変数で指定したパスの`lib/ICRP-07.NDX`ファイルが初回起動時に`data/`にコピーされます
+
+### 4. 動作確認
 Claude Desktopで以下のようにテストできます：
 ```
 放射線遮蔽計算用のコンクリート壁（100cm x 50cm x 30cm）を作成してください
@@ -255,7 +282,7 @@ poker_mcp/
 - **エラー回復**: ロールバック機能付き
 - **レスポンス速度**: <50ms応答時間
 
-### **✅ エラーハンドリング強化（v1.2.0）**
+### **✅ エラーハンドリング強化（v1.2.5）**
 - **propose/update自動判別**: エラーメッセージによる適切なメソッド案内
 - **専用エラーコード**: 各操作に固有のエラーコード体系
 - **材料名サジェスト**: 類似材料名の自動提案機能
@@ -296,7 +323,7 @@ poker_mcp/
 
 ## 📝 更新履歴
 
-### v1.2.0 (2025-01-24)
+### v1.2.5 (2025-01-24)
 - ✨ 衝突検出システム実装
 - ✨ 子孫核種自動補完機能追加（ICRP-07統合）
 - ✨ 単位系完全性検証強化（4キー保証）
@@ -326,6 +353,6 @@ poker_mcp/
 
 ---
 
-**🎯 Poker MCP Server v1.2.0**  
+**🎯 Poker MCP Server v1.2.5**  
 **プロトコル**: MCP 1.0.0 完全準拠  
 **作者**: Yoshihiro Hirao | **ライセンス**: ISC

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "poker-mcp",
-  "version": "1.2.0",
-  "description": "YAML-based input file management tool for radiation shielding calculation code POKER with MCP support - Enhanced with collision detection and daughter nuclide auto-completion",
+  "version": "1.2.6",
+  "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",
   "bin": {
@@ -48,7 +48,6 @@
   },
   "files": [
     "src/",
-    "data/",
     "README.md",
     ".mcp.json"
   ]

package/src/config/ConfigManager.js

@@ -1,14 +1,21 @@
 // src/config/ConfigManager.js
 import fs from 'fs/promises';
 import path from 'path';
+import { fileURLToPath } from 'url';
 import { logger } from '../utils/logger.js';
 import { DataError } from '../utils/errors.js';
+import { USER_CONFIG } from '../utils/paths.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname  = path.dirname(__filename);
 
 export class ConfigManager {
   constructor() {
     this.config = null;
-    this.configPath = 'src/config/default.json';
-    this.userConfigPath = 'config.json';
+    // default.json はパッケージ同梱なので __dirname 基準の絶対パスで解決
+    this.configPath     = path.join(__dirname, 'default.json');
+    // ユーザー設定は POKER_MCP_HOME 配下に置く
+    this.userConfigPath = USER_CONFIG;
   }
 
   async load() {

package/src/mcp/server.js

@@ -7,9 +7,10 @@ import { allTools } from './tools/index.js';
 import { createAllHandlers } from './handlers/index.js';
 import { safeExecute } from './middleware/errorHandler.js';
 import { logger } from '../utils/logger.js';
+import { YAML_FILE, PENDING_FILE } from '../utils/paths.js';
 
 export class PokerMcpServer {
-  constructor(yamlFile = 'tasks/poker.yaml', pendingFile = 'tasks/pending_changes.json') {
+  constructor(yamlFile = YAML_FILE, pendingFile = PENDING_FILE) {
     this.server = new Server(
       {
         name: 'poker-mcp',

package/src/mcp_server_stdio_v4.js

@@ -1,45 +1,47 @@
-#!/usr/bin/env node
-// mcp_server_stdio_v4.js - MCP専用版（stdout汚染防止）
-import { PokerMcpServer } from './mcp/server.js';
-import { logger } from './utils/logger.js';
-
-async function main() {
-  try {
-    const server = new PokerMcpServer();
-    await server.initialize();
-    await server.start();
-  } catch (error) {
-    logger.error('サーバー起動失敗', { error: error.message });
-    // console.errorは削除（stdout汚染防止）
-    process.exit(1);
-  }
-}
-
-// 未処理の例外とプロミス拒否のハンドリング
-process.on('uncaughtException', (error) => {
-  logger.error('Uncaught Exception', { error: error.message, stack: error.stack });
-  // console.errorは削除（stdout汚染防止）
-  process.exit(1);
-});
-
-process.on('unhandledRejection', (reason, promise) => {
-  logger.error('Unhandled Rejection', { reason: reason?.message || reason, promise });
-  // console.errorは削除（stdout汚染防止）
-  process.exit(1);
-});
-
-// グレースフルシャットダウン
-process.on('SIGINT', () => {
-  logger.info('SIGINT受信、サーバーを終了します');
-  process.exit(0);
-});
-
-process.on('SIGTERM', () => {
-  logger.info('SIGTERM受信、サーバーを終了します');
-  process.exit(0);
-});
-
-main().catch((error) => {
-  logger.error('メイン関数エラー', { error: error.message });
-  process.exit(1);
-});
+#!/usr/bin/env node
+// mcp_server_stdio_v4.js - MCP専用版（stdout汚染防止）
+import { PokerMcpServer } from './mcp/server.js';
+import { logger } from './utils/logger.js';
+
+async function main() {
+  try {
+    const server = new PokerMcpServer();
+    await server.initialize();
+    await server.start();
+  } catch (error) {
+    logger.error('サーバー起動失敗', { error: error.message });
+    // stdoutは汚染禁止だが、stderrへの出力は許容（Claude Desktopがログに記録する）
+    process.stderr.write(`[poker-mcp] Fatal: ${error.message}\n`);
+    process.exit(1);
+  }
+}
+
+// 未処理の例外とプロミス拒否のハンドリング
+process.on('uncaughtException', (error) => {
+  logger.error('Uncaught Exception', { error: error.message, stack: error.stack });
+  process.stderr.write(`[poker-mcp] Uncaught Exception: ${error.message}\n`);
+  process.exit(1);
+});
+
+process.on('unhandledRejection', (reason, promise) => {
+  logger.error('Unhandled Rejection', { reason: reason?.message || reason, promise });
+  process.stderr.write(`[poker-mcp] Unhandled Rejection: ${reason?.message || reason}\n`);
+  process.exit(1);
+});
+
+// グレースフルシャットダウン
+process.on('SIGINT', () => {
+  logger.info('SIGINT受信、サーバーを終了します');
+  process.exit(0);
+});
+
+process.on('SIGTERM', () => {
+  logger.info('SIGTERM受信、サーバーを終了します');
+  process.exit(0);
+});
+
+main().catch((error) => {
+  logger.error('メイン関数エラー', { error: error.message });
+  process.stderr.write(`[poker-mcp] Main error: ${error.message}\n`);
+  process.exit(1);
+});

package/src/services/DataManager.js

@@ -7,13 +7,16 @@ import { DataError } from '../utils/errors.js';
 import CollisionDetector from '../utils/CollisionDetector.js';
 import NuclideManager from '../utils/NuclideManager.js';
 import EnhancedValidator from '../utils/EnhancedValidator.js';
+import { BACKUPS_DIR, LOGS_DIR, TASKS_DIR, DATA_DIR, NDX_FILE,
+         YAML_FILE, PENDING_FILE } from '../utils/paths.js';
 
 export class SafeDataManager {
   constructor(yamlFile, pendingFile) {
-    this.yamlFile = yamlFile;
-    this.pendingFile = pendingFile;
-    this.backupDir = 'backups';
-    this.maxBackups = 10;
+    // 引数が省略された場合は paths.js の絶対パスをデフォルトとして使用
+    this.yamlFile    = yamlFile    ?? YAML_FILE;
+    this.pendingFile = pendingFile ?? PENDING_FILE;
+    this.backupDir   = BACKUPS_DIR;
+    this.maxBackups  = 10;
     this.data = null;
     this.pendingChanges = [];
     
@@ -24,11 +27,11 @@ export class SafeDataManager {
       max_auto_corrections: 10
     });
     
-    // 核種管理の初期化
+    // 核種管理の初期化（絶対パスを使用）
     this.nuclideManager = new NuclideManager({
       contribution_threshold: 0.05,
       user_confirmation: true,
-      database_file: 'data/ICRP-07.NDX'
+      database_file: NDX_FILE
     });
     
     // 強化検証の初期化
@@ -41,10 +44,14 @@ export class SafeDataManager {
 
   async initialize() {
     try {
-      // 必要なフォルダをすべて作成
-      await fs.mkdir(this.backupDir, { recursive: true });  // backups
-      await fs.mkdir('logs', { recursive: true });          // logs  
-      await fs.mkdir('tasks', { recursive: true });         // tasks
+      // 必要なフォルダをすべて作成（絶対パスで権限エラーを回避）
+      await fs.mkdir(BACKUPS_DIR, { recursive: true });  // backups
+      await fs.mkdir(LOGS_DIR,    { recursive: true });  // logs
+      await fs.mkdir(TASKS_DIR,   { recursive: true });  // tasks
+      await fs.mkdir(DATA_DIR,    { recursive: true });  // data
+
+      // 必要なデータファイルをコピー
+      await this.ensureDataFiles();
 
       // 初期ファイル配置（既存ファイルがない場合のみ）
       await this.ensureInitialFiles();
@@ -63,6 +70,85 @@ export class SafeDataManager {
     }
   }
 
+  // 新規メソッド: 必要なデータファイルの確保
+  async ensureDataFiles() {
+    try {
+      const targetFile = NDX_FILE;  // 絶対パスを使用
+      
+      // ターゲットファイルの存在チェック
+      try {
+        await fs.access(targetFile);
+        logger.info('ICRP-07データベースファイルは既に存在します。コピーをスキップします。', { 
+          file: targetFile 
+        });
+        return; // 既に存在する場合は何もしない
+      } catch (targetError) {
+        if (targetError.code !== 'ENOENT') {
+          // アクセス権限などの別のエラー
+          throw targetError;
+        }
+        // ファイルが存在しない場合は以下の処理を続行
+      }
+      
+      // 環境変数からインストールパスを取得（デフォルト値設定）
+      const installPath = process.env.POKER_INSTALL_PATH || 'C:/Poker';
+      logger.info('POKERインストールパスを確認', { installPath });
+      
+      const sourceFile = path.join(installPath, 'lib', 'ICRP-07.NDX');
+      
+      // ソースファイルの存在チェック
+      try {
+        await fs.access(sourceFile);
+        logger.info('ソースファイルが見つかりました', { sourceFile });
+      } catch (sourceError) {
+        if (sourceError.code === 'ENOENT') {
+          logger.error('ソースファイルが見つかりません', {
+            expectedPath: sourceFile,
+            installPath: installPath,
+            environmentVariable: 'POKER_INSTALL_PATH',
+            suggestion: installPath === 'C:/Poker' 
+              ? 'POKER_INSTALL_PATH環境変数を正しいインストールディレクトリに設定してください'
+              : 'インストールディレクトリに lib/ICRP-07.NDX ファイルが存在することを確認してください'
+          });
+          throw new DataError(
+            `必要なデータファイルが見つかりません: ${sourceFile}`, 
+            'MISSING_SOURCE_FILE'
+          );
+        } else {
+          throw sourceError;
+        }
+      }
+      
+      // ファイルをコピー
+      try {
+        await fs.copyFile(sourceFile, targetFile);
+        logger.info('ICRP-07データベースファイルをコピーしました', { 
+          from: sourceFile, 
+          to: targetFile 
+        });
+      } catch (copyError) {
+        logger.error('ファイルのコピーに失敗しました', {
+          error: copyError.message,
+          sourceFile,
+          targetFile
+        });
+        throw copyError;
+      }
+      
+      // コピー完了後のファイルサイズ確認
+      const finalStats = await fs.stat(targetFile);
+      logger.info('ICRP-07データベースファイルのコピーが完了しました', {
+        file: targetFile,
+        size: finalStats.size,
+        readable: true
+      });
+      
+    } catch (error) {
+      logger.error('データファイル確保エラー', { error: error.message });
+      throw error;
+    }
+  }
+
   // 新規メソッド: 初期ファイルの確実な配置
   async ensureInitialFiles() {
     try {

package/src/utils/logger.js

@@ -1,24 +1,29 @@
-// utils/logger.js - MCP専用版（stdout汚染防止）
-import winston from 'winston';
-import path from 'path';
-
-const logger = winston.createLogger({
-  level: process.env.LOG_LEVEL || 'info',
-  format: winston.format.combine(
-    winston.format.timestamp(),
-    winston.format.errors({ stack: true }),
-    winston.format.json()
-  ),
-  transports: [
-    new winston.transports.File({ 
-      filename: path.join('logs', 'error.log'), 
-      level: 'error' 
-    }),
-    new winston.transports.File({ 
-      filename: path.join('logs', 'combined.log') 
-    })
-    // Console transportは削除（MCPサーバーではstdout汚染禁止）
-  ]
-});
-
-export { logger };
+// utils/logger.js - MCP専用版（stdout汚染防止）
+import winston from 'winston';
+import path from 'path';
+import fs from 'fs';
+import { LOGS_DIR } from './paths.js';
+
+// ログディレクトリを起動時に確実に作成（相対パス問題を回避）
+fs.mkdirSync(LOGS_DIR, { recursive: true });
+
+const logger = winston.createLogger({
+  level: process.env.LOG_LEVEL || 'info',
+  format: winston.format.combine(
+    winston.format.timestamp(),
+    winston.format.errors({ stack: true }),
+    winston.format.json()
+  ),
+  transports: [
+    new winston.transports.File({ 
+      filename: path.join(LOGS_DIR, 'error.log'), 
+      level: 'error' 
+    }),
+    new winston.transports.File({ 
+      filename: path.join(LOGS_DIR, 'combined.log') 
+    })
+    // Console transportは削除（MCPサーバーではstdout汚染禁止）
+  ]
+});
+
+export { logger };

package/src/utils/paths.js

@@ -0,0 +1,24 @@
+// utils/paths.js - 実行時データの格納先を一元管理
+//
+// 優先順位:
+//   1. 環境変数 POKER_MCP_HOME が設定されていれば、その値を使用
+//   2. 未設定なら os.homedir()/.poker-mcp/ をデフォルトとする
+//
+// claude_desktop_config.json での設定例:
+//   "env": { "POKER_MCP_HOME": "C:\\Users\\yoshi\\poker_mcp_workspace" }
+//
+import path from 'path';
+import os from 'os';
+
+export const BASE_DIR = process.env.POKER_MCP_HOME
+  ?? path.join(os.homedir(), '.poker-mcp');
+
+export const LOGS_DIR   = path.join(BASE_DIR, 'logs');
+export const TASKS_DIR  = path.join(BASE_DIR, 'tasks');
+export const BACKUPS_DIR = path.join(BASE_DIR, 'backups');
+export const DATA_DIR   = path.join(BASE_DIR, 'data');
+
+export const YAML_FILE    = path.join(TASKS_DIR,  'poker.yaml');
+export const PENDING_FILE = path.join(TASKS_DIR,  'pending_changes.json');
+export const NDX_FILE     = path.join(DATA_DIR,   'ICRP-07.NDX');
+export const USER_CONFIG  = path.join(BASE_DIR,   'config.json');