localizationExportJson
Export translations for a specific language to JSON format from localization files. Specify file path and language to generate structured translation data.
Instructions
將特定語言的翻譯導出為JSON格式
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filePath | Yes | ||
| language | Yes |
Implementation Reference
- tools/localizationTool.ts:449-467 (handler)The core handler function that reads the CSV localization file, extracts translations for the specified language, and returns them as a formatted JSON object.
static async exportLanguageAsJson(filePath: string, language: string): Promise<string> { try { const records = await this.getCSVData(filePath); // 創建Key-Value的映射 const langData: Record<string, string> = {}; for (const entry of records) { if (entry.Key && entry[language]) { langData[entry.Key] = entry[language]; } } return JSON.stringify(langData, null, 2); } catch (error) { console.error(`匯出語言資料失敗: ${error instanceof Error ? error.message : '未知錯誤'}`); throw error; } } - main.ts:416-430 (registration)Registers the 'localizationExportJson' tool with the MCP server, defines the input schema, and provides a wrapper handler that calls the core implementation and formats the MCP response.
server.tool("localizationExportJson", "將特定語言的翻譯導出為JSON格式", { filePath: z.string(), language: z.string() }, async ({ filePath, language }) => { try { const result = await LocalizationTool.exportLanguageAsJson(filePath, language); return { content: [{ type: "text", text: result }] }; } catch (error) { return { content: [{ type: "text", text: `匯出失敗: ${error instanceof Error ? error.message : "未知錯誤"}` }] }; } } - main.ts:418-418 (schema)Zod schema defining the input parameters: filePath (string) and language (string).
{ filePath: z.string(), language: z.string() }, - tools/localizationTool.ts:8-14 (schema)TypeScript interface defining the structure of localization entries in the CSV file, used by the tool's parsing logic.
export interface LocalizationEntry { Key: string; 'zh-TW': string; 'zh-CN': string; en: string; [key: string]: string; // 其他可能的語言欄位 } - tools/localizationTool.ts:180-205 (helper)Helper method that loads and parses the CSV file into LocalizationEntry array, with caching for efficiency. Used by the handler.
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; } }