GonMCPtool

Instructions

Implementation Reference

• main.ts:456-475 (registration)

  Registers the MCP tool 'localizationFindLongValues' with input schema (filePath: string, threshold: number, optional language and limit) and delegates execution to LocalizationTool.findLongValues from tools/localizationTool.ts.

  server.tool("localizationFindLongValues",
      "查找超過特定字數的翻譯項目",
      {
          filePath: z.string(),
          threshold: z.number(),
          language: z.string().optional(),
          limit: z.number().optional()
      },
      async ({ filePath, threshold, language = '', limit = 50 }) => {
          try {
              const results = await LocalizationTool.findLongValues(filePath, threshold, language, limit);
              return {
                  content: [{ type: "text", text: JSON.stringify(results, null, 2) }]
              };
          } catch (error) {
              return {
                  content: [{ type: "text", text: `搜尋超長文字失敗: ${error instanceof Error ? error.message : "未知錯誤"}` }]
              };
          }
      }

• tools/localizationTool.ts:562-619 (handler)

  Core handler implementation: Loads CSV data via cached getCSVData, iterates over entries and languages, collects those exceeding threshold length, sorts by descending length, limits results, returns LongValueResult.

  static async findLongValues(
    filePath: string, 
    threshold: number, 
    language: string = '', 
    limit: number = 50
  ): Promise<LongValueResult> {
    try {
      if (threshold <= 0) {
        throw new Error('字數閾值必須大於0');
      }
  
      const records = await this.getCSVData(filePath);
      
      // 用於存儲結果的陣列
      const longValues: Array<{
        key: string;
        language: string;
        value: string;
        length: number;
      }> = [];
  
      // 遍歷所有記錄
      for (const entry of records) {
        if (!entry.Key) continue;
  
        // 取得要檢查的語言欄位
        const languagesToCheck = language 
          ? [language] 
          : Object.keys(entry).filter(key => key !== 'Key');
  
        // 檢查每個語言欄位
        for (const lang of languagesToCheck) {
          if (entry[lang] && entry[lang].length > threshold) {
            longValues.push({
              key: entry.Key,
              language: lang,
              value: entry[lang],
              length: entry[lang].length
            });
          }
        }
      }
  
      // 依長度降序排序
      longValues.sort((a, b) => b.length - a.length);
  
      // 限制返回數量
      const limitedResults = longValues.slice(0, limit);
  
      return {
        totalResults: longValues.length,
        entries: limitedResults
      };
    } catch (error) {
      console.error(`搜尋長文字失敗: ${error instanceof Error ? error.message : '未知錯誤'}`);
      throw error;
    }
  }

• tools/localizationTool.ts:27-35 (schema)

  TypeScript interface defining the output schema for the tool's results: total count and array of long value entries with key, language, value, and length.

  export interface LongValueResult {
    totalResults: number;
    entries: Array<{
      key: string;
      language: string;
      value: string;
      length: number;
    }>;
  }

• main.ts:458-462 (schema)

  Zod schema defining the input parameters for the tool: required filePath and threshold, optional language and limit.

  {
      filePath: z.string(),
      threshold: z.number(),
      language: z.string().optional(),
      limit: z.number().optional()

• tools/localizationTool.ts:180-205 (helper)

  Cached CSV data loader used by the handler: reads and parses CSV file content, handles manual parsing fallback, manages 30s cache to avoid repeated reads.

  private static async getCSVData(filePath: string, force = false): Promise<LocalizationEntry[]> {
    const now = Date.now();
    const cached = this.cache.get(filePath);
  
    // 如果緩存有效且不需要強制重新讀取
    if (!force && cached && (now - cached.timestamp < this.CACHE_EXPIRY)) {
      return cached.data;
    }
  
    try {
      // 讀取並解析CSV檔案
      const content = await this.readCSVFileRaw(filePath);
      const records = this.parseCSVContent(content);
      
      // 更新緩存
      this.cache.set(filePath, {
        data: records,
        timestamp: now
      });
      
      return records;
    } catch (error) {
      console.error(`解析CSV檔案失敗: ${error instanceof Error ? error.message : '未知錯誤'}`);
      throw error;
    }
  }