Poker Task Management MCP

Instructions

Implementation Reference

• src/mcp/tools/buildupFactorTools.js:27-48 (schema)

  Tool schema and metadata definition for 'poker_updateBuildupFactor', including input validation schema.

  {
    name: 'poker_updateBuildupFactor',
    description: '既存ビルドアップ係数の設定を更新します',
    inputSchema: {
      type: 'object',
      properties: {
        material: {
          type: 'string',
          description: '更新する材料名'
        },
        use_slant_correction: {
          type: 'boolean',
          description: '新しいスラント補正設定'
        },
        use_finite_medium_correction: {
          type: 'boolean',
          description: '新しい有限媒体補正設定'
        }
      },
      required: ['material']
    }
  },

• src/mcp/handlers/buildupFactorHandlers.js:60-85 (handler)

  MCP tool handler function for updateBuildupFactor. Validates input, calls TaskManager.updateBuildupFactor, handles specific errors.

  async updateBuildupFactor(args) {
    try {
      if (!args.material) throw new ValidationError('材料名は必須です', 'material', args.material);
      const { material, ...updates } = args;
      const result = await taskManager.updateBuildupFactor(material, updates);
      return { success: true, message: result };
    } catch (error) {
      logger.error('updateBuildupFactorハンドラーエラー', { args, error: error.message });
      
      // マニフェスト仕様のupdate専用エラーコード処理
      if (error.code === -32071) {
        return {
          success: false,
          error: error.message,
          details: {
            errorCode: error.code,
            suggestion: 'proposeBuildupFactorメソッドを使用してください',
            missingObject: args.material,
            objectType: 'ビルドアップ係数'
          }
        };
      }
      
      throw error;
    }
  },

• src/mcp/server.js:43-57 (registration)

  MCP server registration and dispatch logic. Maps 'poker_*' tool names to handlers by stripping 'poker_' prefix.

  this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
    const { name, arguments: args } = request.params;
    
    logger.info(`MCP Tool実行: ${name}`, { args });
    
    // ハンドラー名をツール名から生成（プレフィックス除去）
    const handlerName = name.replace('poker_', '');
    
    const handler = this.handlers[handlerName];
    if (!handler) {
      throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
    }
    
    return await safeExecute(async () => handler(args), { tool: name })();
  });

• src/services/TaskManager.js:1257-1275 (helper)

  TaskManager method that adds a pending change for updating buildup factor settings.

  async updateBuildupFactor(material, updates) {
    try {
      if (!material) throw new ValidationError('materialは必須です', 'material', material);
      
      // 既存更新専用チェック - マニフェスト仕様準拠
      this.validateUpdatePrerequisites('buildup_factor', material, (m) => this.findBuildupFactorByMaterial(m));
      
      await this.dataManager.addPendingChange({
        action: 'updateBuildupFactor',
        data: { material, ...updates }
      });
      logger.info('ビルドアップ係数更新を提案しました', { material, updates });
      return `提案: ビルドアップ係数 ${material} の更新を保留しました`;
      
    } catch (error) {
      logger.error('ビルドアップ係数更新エラー', { material, error: error.message });
      throw error;
    }
  }

• src/services/DataManager.js:484-496 (helper)

  DataManager logic to apply the updateBuildupFactor pending change by modifying the buildup_factor array in data.

  case 'updateBuildupFactor':
    if (this.data.buildup_factor) {
      const buildup = this.data.buildup_factor.find(bf => bf.material === data.material);
      if (buildup) {
        if ('use_slant_correction' in data) {
          buildup.use_slant_correction = data.use_slant_correction;
        }
        if ('use_finite_medium_correction' in data) {
          buildup.use_finite_medium_correction = data.use_finite_medium_correction;
        }
      }
    }
    break;