@camscanner/mcp-language-server 1.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "camscanner-plugins",
+  "owner": {
+    "name": "CamScanner"
+  },
+  "plugins": [
+    {
+      "name": "i18n",
+      "description": "CamScanner multi-language string integration plugin. Search, export, and write locale strings via MCP language server.",
+      "source": "./plugins/i18n",
+      "category": "development"
+    },
+    {
+      "name": "yapi",
+      "description": "YApi API documentation management plugin. Search, query, create, and export API documentation via YApi MCP server.",
+      "source": "./plugins/yapi",
+      "category": "development"
+    }
+  ]
+}

package/README.md

@@ -0,0 +1,48 @@
+# CamScanner i18n MCP Language Server
+
+用于 Claude Code 的多语言字符串管理 MCP Server，支持从 CamScanner 运营平台搜索、导出、写入多语言字符串。
+
+## 功能
+
+| 工具 | 说明 |
+|------|------|
+| `authenticate` | 浏览器登录运营平台 |
+| `logout` | 退出登录，清除凭证 |
+| `search-string` | 按关键词搜索多语言字符串 |
+| `export-string` | 导出为 cs-i18n 兼容的 locale JSON |
+| `write-locales` | 将字符串直接写入项目 locales 目录 |
+| `get-version-list` | 获取产品版本列表 |
+
+## 安装
+
+```bash
+# 1. 添加市场（仅首次）
+claude plugin marketplace add tianmuji/camscanner-plugins
+
+# 2. 安装插件
+claude plugin install i18n@camscanner-plugins
+```
+
+安装后重启 Claude Code 即可使用。插件会自动注册 MCP Server 和 `/i18n` Skill。
+
+### 前提条件
+
+- Node.js >= 18
+- Playwright Chromium（用于浏览器登录）：`npx playwright install chromium`
+
+## 认证
+
+首次使用时调用 `authenticate` 工具，会打开浏览器进行 SSO 登录（扫码验证 + 密码）。
+
+- 浏览器数据持久化在 `~/.language-mcp/browser-data/`，保存的密码下次自动填充
+- 认证信息保存在 `~/.language-mcp/credentials.json`，有效期 24 小时
+
+## 常用产品 ID
+
+| ID | 产品 |
+|----|------|
+| 1 | CamCard |
+| 2 | CamScanner |
+| 44 | CamScanner Lite |
+| 47 | CS PDF |
+| 53 | CS Harmony |

package/dist/auth.d.ts

@@ -0,0 +1,12 @@
+import type { OperateCredentials } from './operate-client.js';
+export declare function loadCredentials(): Promise<OperateCredentials | null>;
+export declare function saveCredentials(creds: OperateCredentials): Promise<void>;
+export declare function clearCredentials(): Promise<void>;
+export interface SsoConfig {
+    operateBaseUrl: string;
+}
+/**
+ * Launch a browser for the user to complete the full login flow
+ * (SSO + zero-trust gateway), then extract all cookies and CSRF token.
+ */
+export declare function startSsoLogin(config: SsoConfig): Promise<OperateCredentials>;

package/dist/auth.js

@@ -0,0 +1,141 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCredentials = loadCredentials;
+exports.saveCredentials = saveCredentials;
+exports.clearCredentials = clearCredentials;
+exports.startSsoLogin = startSsoLogin;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const playwright_core_1 = require("playwright-core");
+// --- Credentials persistence ---
+const CREDS_DIR = path_1.default.join(os_1.default.homedir(), '.language-mcp');
+const CREDS_FILE = path_1.default.join(CREDS_DIR, 'credentials.json');
+async function loadCredentials() {
+    try {
+        if (!fs_1.default.existsSync(CREDS_FILE))
+            return null;
+        const data = JSON.parse(fs_1.default.readFileSync(CREDS_FILE, 'utf-8'));
+        if (data && data.expiresAt > Date.now())
+            return data;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+async function saveCredentials(creds) {
+    if (!fs_1.default.existsSync(CREDS_DIR))
+        fs_1.default.mkdirSync(CREDS_DIR, { recursive: true });
+    fs_1.default.writeFileSync(CREDS_FILE, JSON.stringify(creds, null, 2));
+}
+async function clearCredentials() {
+    try {
+        fs_1.default.unlinkSync(CREDS_FILE);
+    }
+    catch { /* ignore */ }
+}
+// --- Find system Chromium installed by Playwright ---
+function findChromium() {
+    const cacheDir = path_1.default.join(os_1.default.homedir(), 'Library', 'Caches', 'ms-playwright');
+    if (!fs_1.default.existsSync(cacheDir))
+        return undefined;
+    const dirs = fs_1.default.readdirSync(cacheDir)
+        .filter(d => d.startsWith('chromium-'))
+        .sort()
+        .reverse();
+    for (const dir of dirs) {
+        const candidates = [
+            path_1.default.join(cacheDir, dir, 'chrome-mac-arm64', 'Google Chrome for Testing.app', 'Contents', 'MacOS', 'Google Chrome for Testing'),
+            path_1.default.join(cacheDir, dir, 'chrome-mac', 'Google Chrome for Testing.app', 'Contents', 'MacOS', 'Google Chrome for Testing'),
+            path_1.default.join(cacheDir, dir, 'chrome-mac-arm64', 'Chromium.app', 'Contents', 'MacOS', 'Chromium'),
+            path_1.default.join(cacheDir, dir, 'chrome-mac', 'Chromium.app', 'Contents', 'MacOS', 'Chromium'),
+            path_1.default.join(cacheDir, dir, 'chrome-linux', 'chrome'),
+        ];
+        for (const c of candidates) {
+            if (fs_1.default.existsSync(c))
+                return c;
+        }
+    }
+    return undefined;
+}
+/**
+ * Launch a browser for the user to complete the full login flow
+ * (SSO + zero-trust gateway), then extract all cookies and CSRF token.
+ */
+async function startSsoLogin(config) {
+    const execPath = findChromium();
+    if (!execPath) {
+        throw new Error('Cannot find Chromium. Please install Playwright browsers: npx playwright install chromium');
+    }
+    // Persistent browser data dir — saves passwords, cookies across sessions
+    const userDataDir = path_1.default.join(CREDS_DIR, 'browser-data');
+    if (!fs_1.default.existsSync(userDataDir))
+        fs_1.default.mkdirSync(userDataDir, { recursive: true });
+    // Navigate to a page that requires auth — this triggers the SSO redirect chain
+    const targetUrl = config.operateBaseUrl + '/multilanguage/edit-language';
+    console.error('[Auth] Launching browser for login...');
+    const context = await playwright_core_1.chromium.launchPersistentContext(userDataDir, {
+        headless: false,
+        executablePath: execPath,
+        ignoreHTTPSErrors: true,
+    });
+    try {
+        const page = context.pages()[0] || await context.newPage();
+        await page.goto(targetUrl, { waitUntil: 'domcontentloaded', timeout: 15000 });
+        // If already logged in (browser has valid cookies from previous session), skip waiting
+        const currentHost = new URL(page.url()).hostname;
+        if (currentHost !== 'operate.intsig.net') {
+            console.error('[Auth] Waiting for user to complete login (up to 180s)...');
+            await page.waitForURL(url => {
+                const u = typeof url === 'string' ? new URL(url) : url;
+                return u.hostname === 'operate.intsig.net';
+            }, { timeout: 180000 });
+        }
+        // Ensure the page is fully loaded
+        await page.waitForLoadState('networkidle', { timeout: 15000 }).catch(() => { });
+        // Extract all cookies
+        const cookies = await context.cookies();
+        const operateCookies = cookies.filter(c => c.domain.includes('intsig.net') || c.domain.includes('operate'));
+        if (operateCookies.length === 0) {
+            throw new Error('No cookies captured after login. Please try again.');
+        }
+        // Navigate to /site/get-config to extract CSRF token
+        await page.goto(config.operateBaseUrl + '/site/get-config', { waitUntil: 'domcontentloaded', timeout: 15000 });
+        // Re-capture cookies (get-config may refresh JSESSID)
+        const allCookies = (await context.cookies()).filter(c => c.domain.includes('intsig.net') || c.domain.includes('operate'));
+        const finalCookie = allCookies.map(c => `${c.name}=${c.value}`).join('; ');
+        let csrfToken = '';
+        try {
+            csrfToken = await page.evaluate(`
+        (() => {
+          const el = document.querySelector('input[name="_csrf"]');
+          return el ? el.value : '';
+        })()
+      `);
+        }
+        catch { /* ignore */ }
+        if (!csrfToken) {
+            const html = await page.content();
+            const match = html.match(/name="_csrf"\s+value="([^"]+)"/);
+            if (match)
+                csrfToken = match[1];
+        }
+        if (!csrfToken) {
+            throw new Error('Login succeeded but failed to extract CSRF token. Please try again.');
+        }
+        console.error('[Auth] Login successful! Cookies and CSRF token captured.');
+        return {
+            ssoToken: '',
+            sessionCookie: finalCookie,
+            csrfToken,
+            expiresAt: Date.now() + 24 * 60 * 60 * 1000,
+        };
+    }
+    finally {
+        await context.close();
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,299 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const v3_1 = require("zod/v3");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const operate_client_js_1 = require("./operate-client.js");
+const auth_js_1 = require("./auth.js");
+const utils_js_1 = require("./utils.js");
+// --- Config from env ---
+const OPERATE_BASE_URL = process.env.OPERATE_BASE_URL;
+if (!OPERATE_BASE_URL) {
+    console.error('Error: OPERATE_BASE_URL environment variable is required');
+    process.exit(1);
+}
+const ssoConfig = {
+    operateBaseUrl: OPERATE_BASE_URL,
+};
+const client = new operate_client_js_1.OperateClient(OPERATE_BASE_URL);
+// --- Auth helper ---
+async function requireAuth() {
+    if (!client.isAuthenticated()) {
+        const savedCreds = await (0, auth_js_1.loadCredentials)();
+        if (savedCreds) {
+            client.setCredentials(savedCreds);
+            console.error('Restored saved credentials (valid until ' + new Date(savedCreds.expiresAt).toLocaleString() + ')');
+        }
+    }
+    if (!client.isAuthenticated()) {
+        return "Not authenticated. Please call the 'authenticate' tool first to login via SSO.";
+    }
+    return null;
+}
+// --- MCP Server ---
+const server = new mcp_js_1.McpServer({
+    name: 'language-server',
+    version: '1.0.0',
+});
+// Tool: authenticate
+server.tool('authenticate', 'Login to operate platform via SSO QR code scan. Opens browser for authentication.', {}, async () => {
+    if (client.isAuthenticated()) {
+        return { content: [{ type: 'text', text: "Already authenticated. Use 'logout' tool to re-authenticate." }] };
+    }
+    try {
+        const creds = await (0, auth_js_1.startSsoLogin)(ssoConfig);
+        client.setCredentials(creds);
+        await (0, auth_js_1.saveCredentials)(creds);
+        return { content: [{ type: 'text', text: 'Authentication successful! You can now use all language tools.' }] };
+    }
+    catch (err) {
+        if (err.message?.includes('pre-verification')) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: 'SSO pre-verification completed (no token returned yet). ' +
+                            'Please call \'authenticate\' again immediately to complete authentication.',
+                    }],
+            };
+        }
+        return { content: [{ type: 'text', text: `Authentication failed: ${err.message}` }] };
+    }
+});
+// Tool: logout
+server.tool('logout', 'Clear saved credentials and logout.', {}, async () => {
+    await (0, auth_js_1.clearCredentials)();
+    client.setCredentials(null);
+    return { content: [{ type: 'text', text: "Logged out. Call 'authenticate' to login again." }] };
+});
+// Tool: list-products
+server.tool('list-products', '获取多语言平台的所有产品列表。返回产品名称和对应的 product_id。在不确定 product_id 时先调用此工具。', {}, async () => {
+    const authErr = await requireAuth();
+    if (authErr)
+        return { content: [{ type: 'text', text: authErr }] };
+    const data = await client.post('/common/product/get-product-list', {});
+    if (data.errno !== 0) {
+        return { content: [{ type: 'text', text: `错误: ${data.message || JSON.stringify(data)}` }] };
+    }
+    const products = data.data || {};
+    let output = '产品列表:\n\n';
+    output += '| product_id | 产品名称 |\n|---|---|\n';
+    for (const [name, id] of Object.entries(products)) {
+        output += `| ${id} | ${name} |\n`;
+    }
+    return { content: [{ type: 'text', text: output }] };
+});
+// Tool: list-platforms
+server.tool('list-platforms', '获取多语言平台支持的所有平台列表。返回平台名称和对应的 platform_id。', {}, async () => {
+    let output = '平台列表:\n\n';
+    output += '| platform_id | 平台名称 |\n|---|---|\n';
+    for (const [id, name] of Object.entries(utils_js_1.PLATFORM_MAP)) {
+        output += `| ${id} | ${name} |\n`;
+    }
+    return { content: [{ type: 'text', text: output }] };
+});
+// Tool: get-version-list
+server.tool('get-version-list', '获取指定产品的多语言版本列表。返回每个版本的 version_id、版本号、支持的平台和语言。', {
+    product_id: v3_1.z.string().describe('产品ID,先调用 list-products 查询'),
+}, async ({ product_id }) => {
+    const authErr = await requireAuth();
+    if (authErr)
+        return { content: [{ type: 'text', text: authErr }] };
+    const data = await client.post('/language/mcp-language/get-version-list', { product_id });
+    if (data.errno !== 0) {
+        return { content: [{ type: 'text', text: `错误: ${data.message || JSON.stringify(data)}` }] };
+    }
+    const list = data.data.list || [];
+    const summary = list
+        .map((v) => {
+        const platformNames = (v.platforms || '').split(',').filter(Boolean)
+            .map((id) => utils_js_1.PLATFORM_MAP[Number(id)] || `unknown(${id})`).join(', ');
+        return `- version_id=${v.version_id}, version=${v.version_number}, platforms=[${platformNames}], languages=${v.supported_languages}`;
+    })
+        .join('\n');
+    return { content: [{ type: 'text', text: `共 ${data.data.total} 个版本:\n${summary}` }] };
+});
+// Tool: search-string
+server.tool('search-string', '按关键词搜索多语言字符串。可指定版本精准搜索,返回 string_id、key、中英文翻译等信息。', {
+    product_id: v3_1.z.string().describe('产品ID,先调用 list-products 查询'),
+    word: v3_1.z.string().describe('搜索关键词(中文或英文)'),
+    version_id: v3_1.z.string().optional().describe('版本ID,不传则搜索所有版本'),
+    fuzzy: v3_1.z.string().optional().default('1').describe('1=模糊匹配,0=精确匹配'),
+    page: v3_1.z.string().optional().default('1').describe('页码'),
+    page_size: v3_1.z.string().optional().default('20').describe('每页条数,最大100'),
+}, async ({ product_id, word, version_id, fuzzy, page, page_size }) => {
+    const authErr = await requireAuth();
+    if (authErr)
+        return { content: [{ type: 'text', text: authErr }] };
+    const params = { product_id, word, fuzzy: fuzzy || '1', page: page || '1', page_size: page_size || '20' };
+    if (version_id)
+        params.version_id = version_id;
+    const data = await client.post('/language/mcp-language/get-string-search', params);
+    if (data.errno !== 0) {
+        return { content: [{ type: 'text', text: `错误: ${data.message || JSON.stringify(data)}` }] };
+    }
+    const versions = Array.isArray(data.data) ? data.data : (data.data?.list || []);
+    if (versions.length === 0) {
+        return { content: [{ type: 'text', text: `未找到匹配 "${word}" 的字符串` }] };
+    }
+    let output = `共 ${versions.length} 个版本有匹配结果:\n\n`;
+    for (const version of versions) {
+        output += `## 版本 ${version.version_number} (version_id=${version.version_id})\n`;
+        const strings = version.ar_string || version.strings || [];
+        for (const str of strings) {
+            const keys = str.keys
+                ? Object.entries(str.keys).map(([p, k]) => `platform_${p}: ${k}`).join(', ')
+                : '无';
+            const zhCN = str.values?.['1'] || str.values?.['0'] || '';
+            const enUS = str.values?.['2'] || str.values?.['0'] || '';
+            const zhTW = str.values?.['7'] || '';
+            output += `- string_id: ${str.id}\n`;
+            output += `  key: ${keys}\n`;
+            output += `  中文: ${zhCN}\n`;
+            output += `  英文: ${enUS}\n`;
+            if (zhTW)
+                output += `  繁体: ${zhTW}\n`;
+            output += '\n';
+        }
+    }
+    return { content: [{ type: 'text', text: output }] };
+});
+// Tool: export-string
+server.tool('export-string', '搜索多语言字符串并导出为兼容 cs-i18n 的 locale JSON 格式。支持单语言或全部语言导出,自动将 %s 替换为 {0}/{1}/{2}。', {
+    product_id: v3_1.z.string().describe('产品ID。常用: 1=CamCard, 2=CamScanner, 44=CS Lite, 47=CS PDF, 53=CS Harmony'),
+    word: v3_1.z.string().describe('搜索关键词(中文或英文)'),
+    version_id: v3_1.z.string().optional().describe('版本ID,不传则搜索所有版本'),
+    platform_id: v3_1.z.string().optional().default('4').describe('平台ID,先调用 list-platforms 查询。默认4=Web'),
+    language_id: v3_1.z.string().optional().describe('目标语言ID,不传则导出所有语言。常用: 1=中文, 2=英文, 7=繁体中文'),
+    fuzzy: v3_1.z.string().optional().default('0').describe('0=精确匹配(默认,只导出完全一致的字符串), 1=模糊匹配'),
+}, async ({ product_id, word, version_id, platform_id, language_id, fuzzy }) => {
+    const authErr = await requireAuth();
+    if (authErr)
+        return { content: [{ type: 'text', text: authErr }] };
+    const params = { product_id, word, fuzzy: fuzzy || '0', page: '1', page_size: '100' };
+    if (version_id)
+        params.version_id = version_id;
+    const data = await client.post('/language/mcp-language/get-string-search', params);
+    if (data.errno !== 0) {
+        return { content: [{ type: 'text', text: `错误: ${data.message || JSON.stringify(data)}` }] };
+    }
+    const versions = Array.isArray(data.data) ? data.data : (data.data?.list || []);
+    if (versions.length === 0) {
+        return { content: [{ type: 'text', text: `未找到匹配 "${word}" 的字符串` }] };
+    }
+    const allStrings = (0, utils_js_1.extractStrings)(versions, platform_id || '4');
+    if (language_id) {
+        const localeObj = allStrings[language_id] || {};
+        if (Object.keys(localeObj).length === 0) {
+            return { content: [{ type: 'text', text: `找到字符串但语言ID=${language_id} 无翻译内容` }] };
+        }
+        const localeName = utils_js_1.LANGUAGE_LOCALE_MAP[language_id] || `lang_${language_id}`;
+        const json = JSON.stringify(localeObj, null, 2);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `导出 ${Object.keys(localeObj).length} 条字符串 → ${localeName}.json:\n\n\`\`\`json\n${json}\n\`\`\``,
+                }],
+        };
+    }
+    let output = `共匹配 ${Object.keys(allStrings).length} 种语言:\n\n`;
+    for (const [langId, localeObj] of Object.entries(allStrings)) {
+        const localeName = utils_js_1.LANGUAGE_LOCALE_MAP[langId] || `lang_${langId}`;
+        const json = JSON.stringify(localeObj, null, 2);
+        output += `### ${localeName}.json (语言ID=${langId}, ${Object.keys(localeObj).length} 条)\n\`\`\`json\n${json}\n\`\`\`\n\n`;
+    }
+    return { content: [{ type: 'text', text: output }] };
+});
+// Tool: write-locales
+server.tool('write-locales', '搜索多语言字符串并直接写入项目的 locales 目录,兼容 cs-i18n 工具格式。自动合并到已有的 locale JSON 文件,%s 自动替换为 {0}/{1}/{2}。', {
+    product_id: v3_1.z.string().describe('产品ID。常用: 1=CamCard, 2=CamScanner, 44=CS Lite, 47=CS PDF, 53=CS Harmony'),
+    word: v3_1.z.string().describe('搜索关键词(中文或英文)'),
+    locales_path: v3_1.z.string().describe('locales 目录的绝对路径（需动态检测，不要硬编码）'),
+    version_id: v3_1.z.string().optional().describe('版本ID,不传则搜索所有版本'),
+    platform_id: v3_1.z.string().optional().default('4').describe('平台ID,先调用 list-platforms 查询。默认4=Web'),
+    fuzzy: v3_1.z.string().optional().default('0').describe('0=精确匹配(默认,只写入完全一致的字符串), 1=模糊匹配'),
+}, async ({ product_id, word, locales_path, version_id, platform_id, fuzzy }) => {
+    const authErr = await requireAuth();
+    if (authErr)
+        return { content: [{ type: 'text', text: authErr }] };
+    if (!fs_1.default.existsSync(locales_path)) {
+        return { content: [{ type: 'text', text: `错误: locales 目录不存在: ${locales_path}` }] };
+    }
+    const params = { product_id, word, fuzzy: fuzzy || '0', page: '1', page_size: '100' };
+    if (version_id)
+        params.version_id = version_id;
+    const data = await client.post('/language/mcp-language/get-string-search', params);
+    if (data.errno !== 0) {
+        return { content: [{ type: 'text', text: `错误: ${data.message || JSON.stringify(data)}` }] };
+    }
+    const versions = Array.isArray(data.data) ? data.data : (data.data?.list || []);
+    if (versions.length === 0) {
+        return { content: [{ type: 'text', text: `未找到匹配 "${word}" 的字符串` }] };
+    }
+    const allStrings = (0, utils_js_1.extractStrings)(versions, platform_id || '4');
+    const results = [];
+    let totalKeys = 0;
+    let filesWritten = 0;
+    let filesSkipped = 0;
+    for (const [langId, newEntries] of Object.entries(allStrings)) {
+        const localeName = utils_js_1.LANGUAGE_LOCALE_MAP[langId];
+        if (!localeName) {
+            filesSkipped++;
+            continue;
+        }
+        const filePath = path_1.default.join(locales_path, `${localeName}.json`);
+        if (!fs_1.default.existsSync(filePath)) {
+            filesSkipped++;
+            continue;
+        }
+        let existingObj = {};
+        try {
+            const content = fs_1.default.readFileSync(filePath, 'utf-8');
+            existingObj = JSON.parse(content);
+        }
+        catch {
+            // empty or invalid file
+        }
+        const { merged, keysAdded, keysUpdated } = (0, utils_js_1.mergeLocaleEntries)(existingObj, newEntries);
+        fs_1.default.writeFileSync(filePath, JSON.stringify(merged, null, 2) + '\n');
+        filesWritten++;
+        totalKeys += Object.keys(newEntries).length;
+        if (keysAdded.length > 0 || keysUpdated.length > 0) {
+            results.push(`${localeName}.json: +${keysAdded.length} 新增, ~${keysUpdated.length} 更新`);
+        }
+        else {
+            results.push(`${localeName}.json: 无变化 (${Object.keys(newEntries).length} 条已存在)`);
+        }
+    }
+    // Detect local locale files that got no remote data
+    const localLocaleNames = fs_1.default.readdirSync(locales_path)
+        .filter(f => f.endsWith('.json'))
+        .map(f => f.replace('.json', ''));
+    const missingLocales = (0, utils_js_1.findMissingLocales)(localLocaleNames, Object.keys(allStrings));
+    let output = `写入完成!\n`;
+    output += `- 目录: ${locales_path}\n`;
+    output += `- 写入 ${filesWritten} 个文件, 跳过 ${filesSkipped} 个 (项目中不存在)\n`;
+    output += `- 共 ${totalKeys} 条字符串\n\n`;
+    output += results.map(r => `  ${r}`).join('\n');
+    if (missingLocales.length > 0) {
+        output += `\n\n⚠️ 以下 ${missingLocales.length} 个本地语言文件未获得远程翻译，未被更新:\n`;
+        output += missingLocales.map(name => `  - ${name}.json`).join('\n');
+        output += `\n请确认远程平台是否已为这些语言提供翻译。`;
+    }
+    return { content: [{ type: 'text', text: output }] };
+});
+// --- Start ---
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('Language MCP Server running on stdio');
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});

package/dist/operate-client.d.ts

@@ -0,0 +1,15 @@
+export interface OperateCredentials {
+    ssoToken: string;
+    sessionCookie: string;
+    csrfToken: string;
+    expiresAt: number;
+}
+export declare class OperateClient {
+    private baseUrl;
+    private credentials;
+    constructor(baseUrl: string);
+    setCredentials(creds: OperateCredentials | null): void;
+    isAuthenticated(): boolean;
+    private postOnce;
+    post(path: string, params: Record<string, string>, retries?: number): Promise<any>;
+}

package/dist/operate-client.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperateClient = void 0;
+const http_1 = __importDefault(require("http"));
+const https_1 = __importDefault(require("https"));
+const url_1 = require("url");
+class OperateClient {
+    constructor(baseUrl) {
+        this.credentials = null;
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+    }
+    setCredentials(creds) {
+        this.credentials = creds;
+    }
+    isAuthenticated() {
+        return !!(this.credentials && Date.now() < this.credentials.expiresAt);
+    }
+    postOnce(path, params) {
+        return new Promise((resolve, reject) => {
+            if (!this.credentials) {
+                reject(new Error("Not authenticated. Please call the 'authenticate' tool first."));
+                return;
+            }
+            const url = new url_1.URL(this.baseUrl + path);
+            const mod = url.protocol === 'https:' ? https_1.default : http_1.default;
+            const body = new URLSearchParams(params).toString();
+            const options = {
+                method: 'POST',
+                timeout: 30000,
+                headers: {
+                    'Cookie': this.credentials.sessionCookie,
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    'Content-Length': String(Buffer.byteLength(body)),
+                    'x-csrf-token': this.credentials.csrfToken,
+                    'x-requested-with': 'XMLHttpRequest',
+                    'accept': 'application/json, text/plain, */*',
+                    'origin': this.baseUrl,
+                    'referer': `${this.baseUrl}/multilanguage/edit-language`,
+                },
+            };
+            const req = mod.request(url.toString(), options, (res) => {
+                if (res.statusCode === 302) {
+                    res.resume();
+                    reject(new Error("Authentication expired (302 redirect). Please call 'authenticate' to re-login."));
+                    return;
+                }
+                let respBody = '';
+                res.on('data', (chunk) => (respBody += chunk));
+                res.on('end', () => {
+                    try {
+                        resolve(JSON.parse(respBody));
+                    }
+                    catch {
+                        reject(new Error(`Invalid JSON response from ${path}: ${respBody.substring(0, 300)}`));
+                    }
+                });
+            });
+            req.on('error', reject);
+            req.on('timeout', () => {
+                req.destroy();
+                reject(new Error(`Request timeout: ${path}`));
+            });
+            req.write(body);
+            req.end();
+        });
+    }
+    async post(path, params, retries = 2) {
+        for (let i = 0; i <= retries; i++) {
+            try {
+                return await this.postOnce(path, params);
+            }
+            catch (err) {
+                if (i === retries || !err.message?.includes('timeout'))
+                    throw err;
+                console.error(`[Operate] Retry ${i + 1}/${retries} for ${path}: ${err.message}`);
+            }
+        }
+        throw new Error(`Request failed after ${retries} retries: ${path}`);
+    }
+}
+exports.OperateClient = OperateClient;

package/dist/utils.d.ts

@@ -0,0 +1,17 @@
+export declare const PLATFORM_MAP: Record<number, string>;
+export declare const LANGUAGE_LOCALE_MAP: Record<string, string>;
+export declare function fixPlaceholders(value: string): string;
+export declare function extractStrings(versions: any[], platformId: string): Record<string, Record<string, string>>;
+export interface MergeResult {
+    merged: Record<string, string>;
+    keysAdded: string[];
+    keysUpdated: string[];
+}
+export declare function mergeLocaleEntries(existingObj: Record<string, string>, newEntries: Record<string, string>): MergeResult;
+/**
+ * 找出本地存在但远程未返回翻译的 locale 文件名。
+ * @param localLocaleNames 本地存在的 locale 名称列表（不含 .json 后缀），如 ['ZhCn', 'EnUs', 'JaJp']
+ * @param remoteLanguageIds 远程返回的语言 ID 列表，如 ['1', '2']
+ * @returns 本地存在但远程无数据的 locale 名称列表
+ */
+export declare function findMissingLocales(localLocaleNames: string[], remoteLanguageIds: string[]): string[];