@camscanner/mcp-language-server 1.0.0

package/plugins/i18n/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "i18n",
+  "description": "CamScanner multi-language string integration plugin. Search, export, and write locale strings via MCP language server.",
+  "version": "1.1.0",
+  "author": {
+    "name": "CamScanner"
+  }
+}

package/plugins/i18n/.mcp.json

@@ -0,0 +1,13 @@
+{
+  "language": {
+    "command": "npx",
+    "args": ["-y", "git+https://github.com/tianmuji/mcp-language-server.git"],
+    "env": {
+      "OPERATE_BASE_URL": "https://operate.intsig.net",
+      "SSO_LOGIN_URL": "https://web-sso.intsig.net/login",
+      "SSO_PLATFORM_ID": "OdliDeAnVtlUA5cGwwxZPHUyXtqPCcNw",
+      "SSO_CALLBACK_DOMAIN": "https://www-sandbox.camscanner.com/activity/mcp-auth-callback",
+      "SSO_CALLBACK_PORT": "9877"
+    }
+  }
+}

package/plugins/i18n/skills/i18n/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: i18n
+description: "多语言字符串集成助手。当用户要求集成、查询、替换多语言字符串时触发，或用户提到 i18n、多语言、$t、国际化、翻译等关键词时触发。"
+argument-hint: <要集成的中文字符串>
+disable-model-invocation: false
+---
+
+# 多语言字符串集成助手
+
+帮助用户查询、集成多语言字符串到项目代码中。支持多个产品、多个平台、多种业务线。
+
+## 可用 MCP 工具
+
+来自 language MCP server：
+
+1. **list-products** — 查询所有产品列表（产品名 → product_id）
+2. **list-platforms** — 查询所有平台列表（平台名 → platform_id）
+3. **get-version-list** — 获取指定产品的版本列表
+4. **search-string** — 按关键词搜索多语言字符串（远程多语言平台）
+5. **export-string** — 导出为兼容 cs-i18n 的 locale JSON 格式
+6. **write-locales** — 将字符串写入项目的 locales 目录
+
+## 产品与平台
+
+> **不要硬编码产品或平台 ID。** 使用 `list-products` 和 `list-platforms` 工具动态查询。
+>
+> 不同产品和平台的字符串 key 可能不同。同一条字符串在 Android/iOS/Web 上可能有不同的 key 名称。
+
+## 核心原则
+
+1. **不假设任何项目配置** — 不要硬编码 product_id、platform_id 或 locale 路径
+2. **先了解再实现** — 先检测项目环境，再操作
+3. **不确定就问** — 产品、平台、版本不确定时，询问用户
+
+## 工作流程
+
+当用户请求集成多语言字符串时，**严格按以下步骤执行**：
+
+### 第 0 步：确认产品与平台
+
+如果用户没有明确指定产品和平台：
+
+1. 调用 **list-products** 获取产品列表，展示给用户选择
+2. 调用 **list-platforms** 获取平台列表，让用户确认目标平台
+3. 如果用户已在之前的对话中指定过，或项目 CLAUDE.md 中有记录，则直接使用
+
+记住用户选择的 product_id 和 platform_id，在后续步骤中使用。
+
+### 第 1 步：检测项目多语言目录
+
+**不要假设多语言文件在 `src/locales/`**。需要动态检测当前项目的 locale 目录：
+
+1. **查找 i18n 配置** — 搜索项目中的 i18n 配置文件（如 `i18n.ts`、`i18n.js`、`vue.config.*` 等），确认 locale 文件路径
+2. **搜索 locale 文件** — 使用 Glob 搜索 `**/{locales,locale,lang,i18n}/*.json` 或类似模式
+3. **验证目录结构** — 确认找到的目录包含语言 JSON 文件（如 `ZhCn.json`、`EnUs.json`、`zh-CN.json` 等）
+4. **确认主参考文件** — 找到中文语言文件作为本地搜索的参考
+
+如果找不到或有多个候选目录，**询问用户确认**。
+
+将检测到的路径记为 `LOCALES_DIR`，后续步骤使用。
+
+### 第 2 步：了解现有实现
+
+1. **阅读用户指定的组件/页面代码**，理解当前的 i18n 用法和代码风格
+2. 查看同模块中已有的 `$t()` / `t()` / `i18n.t()` 等调用，确认命名模式和使用惯例
+3. 确认项目使用的 i18n 框架和参数占位符格式（`{0}` / `{name}` / `%s` 等）
+
+### 第 3 步：本地查找（优先）
+
+先在项目本地 locale 文件中搜索，检查是否已存在匹配的字符串：
+
+1. 使用 **Grep 工具**在中文语言文件中搜索用户提供的中文字符串
+2. **严格匹配规则**: value 必须与用户需要的字符串**完全一致**
+3. 如果本地找到了完全匹配的 key → **直接使用该 key，跳到第 5 步**
+
+### 第 4 步：远程查询（本地未找到时）
+
+使用 `search-string` 从远程平台查询：
+
+- `product_id` 使用第 0 步确认的值
+- **必须使用精确匹配**: `fuzzy: "0"`
+- 将结果整理为表格展示（版本、key、中文、英文、繁体）
+- 无匹配结果 → 告知用户需要在多语言平台新增
+
+#### 搜索策略优先级
+
+精确匹配同时匹配 key 名和中文值。按以下优先级搜索：
+
+1. **按 key 名搜索**（最可靠）— 如果已知 key 名（如 `cs_519b_selected_some`），直接用 key 名精确搜索
+2. **按中文值精确搜索** — 适用于不带参数的简单字符串（如 `删除`、`上传图片`）
+3. **模糊搜索 + 人工确认** — 上述方式无结果时的兜底方案
+
+#### 带参数字符串的注意事项
+
+远程平台的占位符格式不统一，同一字符串在不同版本中可能是 `%s`、`%d`、`{0}`，空格也可能不一致。
+例如 `cs_519b_selected_some` 在远程各版本中分别存为：`已选择%s条`、`已选择{0}条`、`已选择 {0} 条`。
+
+因此**带参数的字符串不要用中文值精确搜索**，应该用 key 名搜索。如果不知道 key 名：
+1. 先用模糊搜索 (`fuzzy: "1"`) 定位候选结果
+2. 从结果中确认正确的 key 名
+3. 再用 key 名精确搜索获取完整翻译
+
+### 第 5 步：写入本地 & 替换代码
+
+1. 检查本地是否已有该 key
+2. 如果没有：使用 `write-locales` 写入
+   - `locales_path` 使用第 1 步检测到的 `LOCALES_DIR` **绝对路径**
+   - `product_id` 使用第 0 步确认的值
+   - `platform_id` 使用第 0 步确认的值
+   - **默认精确匹配** (`fuzzy: "0"`)
+   - 搜索词优先使用 **key 名**（尤其是带参数的字符串）
+3. 替换代码中的硬编码字符串为 i18n 调用，**遵循第 2 步中了解到的现有代码风格**

package/plugins/yapi/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "yapi",
+  "description": "YApi API documentation management plugin. Search, query, create, and export API documentation via YApi MCP server.",
+  "version": "1.0.0",
+  "author": {
+    "name": "CamScanner"
+  }
+}

package/plugins/yapi/.mcp.json

@@ -0,0 +1,13 @@
+{
+  "yapi": {
+    "command": "npx",
+    "args": ["-y", "git+https://gitlab.intsig.net/cs-templates/skills/yapi-mcp-server.git"],
+    "env": {
+      "YAPI_BASE_URL": "https://web-api.intsig.net",
+      "SSO_LOGIN_URL": "https://web-sso.intsig.net/login",
+      "SSO_PLATFORM_ID": "odVOyexj6maKIHAXv9LflO8tw7WNOI4I",
+      "SSO_CALLBACK_DOMAIN": "https://static-cdn.camscanner.com/camscanner-activity/mcp-auth-callback.html",
+      "SSO_CALLBACK_PORT": "9876"
+    }
+  }
+}

package/plugins/yapi/skills/yapi/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: yapi
+description: "YApi API文档管理助手。当用户要求查询、搜索、创建、更新、导出API接口文档时触发，或用户提到 YApi、接口文档、API文档、接口定义、swagger 等关键词时触发。"
+argument-hint: <API名称或关键词>
+disable-model-invocation: false
+---
+
+# YApi API文档管理助手
+
+帮助用户通过 YApi MCP Server 查询和管理云端 API 接口文档。
+
+## 可用 MCP 工具
+
+来自 yapi MCP server：
+
+1. **yapi-auth** — SSO 登录（首次使用需要扫码认证）
+2. **yapi-logout** — 退出登录，清除凭证
+3. **list_projects** — 列出用户有权限的所有分组和项目
+4. **list_apis** — 获取项目下所有 API 接口（按分类分组）
+5. **search_api** — 按路径或标题关键词搜索 API 接口
+6. **get_api_detail** — 获取单个 API 的完整定义（参数、请求体、响应体）
+7. **get_project_info** — 获取项目基本信息
+8. **export_swagger** — 导出 Swagger/OpenAPI 格式文档
+9. **import_api_docs** — 批量导入完整 API 文档（支持按分类或关键词过滤）
+10. **create_api** — 创建新 API 接口
+11. **update_api** — 更新已有 API 接口
+
+## 核心原则：先了解再实现
+
+在对接 API 接口之前，**必须先了解当前项目中相关功能的现有实现**：
+
+1. **阅读相关代码** — 找到用户要修改的模块，理解它的 API 调用方式、数据流、错误处理等
+2. **查看周边实现** — 看同模块其他接口是怎么封装的（axios 实例、请求/响应拦截、类型定义），保持一致
+3. **再查 YApi 文档** — 基于对现有代码的理解，从 YApi 获取接口定义，对比差异后再动手
+4. **PRD 与接口冲突时** — 如果 PRD 描述与 YApi 接口定义不一致，向用户确认以哪个为准
+
+## 工作流程
+
+当用户请求查询或操作 API 文档时，**按以下步骤执行**：
+
+### 第 0 步：了解现有实现
+
+1. **阅读用户指定的模块/页面代码**，理解当前的 API 调用方式和数据结构
+2. 查看 `src/api/` 目录下相关的接口封装，确认命名规范、请求方式、类型定义
+3. 了解相关 Store 和组件如何消费接口数据
+4. 这一步不可跳过 — 不理解上下文就对接接口会导致风格不一致或结构错误
+
+### 第 1 步：认证检查
+
+如果尚未认证，先调用 `yapi-auth` 进行登录。
+
+### 第 2 步：确定项目
+
+- 如果用户未指定项目，使用 `list_projects` 列出可用项目让用户选择
+- 如果用户提供了 project_id，直接使用
+
+### 第 3 步：查询接口
+
+根据用户需求选择合适的工具：
+
+- **搜索特定接口**: 使用 `search_api`，提供 project_id 和关键词
+- **浏览所有接口**: 使用 `list_apis` 获取完整接口列表
+- **查看接口详情**: 使用 `get_api_detail` 获取完整定义（包含请求参数、请求体、响应体 schema）
+- **批量获取文档**: 使用 `import_api_docs` 一次性获取多个接口的完整文档
+
+### 第 4 步：展示结果
+
+- 以清晰的格式展示接口信息
+- 包含 HTTP 方法、路径、参数说明、请求体/响应体结构
+- 如果有环境域名信息，展示完整 URL
+- **与第 0 步了解到的现有代码进行对比**，指出差异点
+
+### 创建/更新接口
+
+- **创建接口**: 使用 `create_api`，需要 project_id、cat_id、title、path、method
+- **更新接口**: 使用 `update_api`，需要 interface_id，只修改指定字段

package/setup.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+# CamScanner i18n MCP Server + Plugin 一键安装
+# 用法: bash setup.sh
+set -e
+
+echo "=== CamScanner i18n 多语言工具安装 ==="
+echo ""
+
+# ---- 配置 ----
+MCP_SERVER_DIR="$HOME/mcp-language-server"
+
+# ---- 1. 安装 MCP Server ----
+echo "[1/3] 安装 MCP Language Server..."
+if [ -d "$MCP_SERVER_DIR" ]; then
+  echo "  目录已存在，更新中..."
+  cd "$MCP_SERVER_DIR"
+  git pull 2>/dev/null || echo "  非 git 仓库，跳过更新"
+else
+  echo "  克隆仓库..."
+  git clone git@github.com:tianmuji/mcp-language-server.git "$MCP_SERVER_DIR"
+fi
+
+cd "$MCP_SERVER_DIR"
+if [ -f "package.json" ]; then
+  echo "  安装依赖..."
+  npm install --silent 2>/dev/null
+  echo "  依赖安装完成"
+fi
+
+# ---- 2. 配置 Cookie ----
+echo ""
+echo "[2/3] 配置认证信息..."
+if [ ! -f "$MCP_SERVER_DIR/.cookie" ]; then
+  echo ""
+  echo "  需要配置 Cookie 才能访问多语言平台。"
+  echo "  获取方式："
+  echo "    1. 浏览器打开 https://operate-test.intsig.net/multilanguage"
+  echo "    2. 登录后打开 DevTools → Network"
+  echo "    3. 做一次搜索操作，找到 get-string-search 请求"
+  echo "    4. 右键 → Copy → Copy as cURL"
+  echo "    5. 从 curl 中提取 -b 后面的 cookie 值"
+  echo ""
+  read -p "  粘贴 Cookie 值 (或回车跳过): " COOKIE_VALUE
+  if [ -n "$COOKIE_VALUE" ]; then
+    echo "$COOKIE_VALUE" > "$MCP_SERVER_DIR/.cookie"
+    echo "  Cookie 已保存"
+  else
+    echo "  跳过，稍后请手动写入 $MCP_SERVER_DIR/.cookie"
+  fi
+
+  echo ""
+  read -p "  粘贴 X-CSRF-Token 值 (或回车跳过): " CSRF_VALUE
+  if [ -n "$CSRF_VALUE" ]; then
+    echo "$CSRF_VALUE" > "$MCP_SERVER_DIR/.csrf-token"
+    echo "  CSRF Token 已保存"
+  else
+    echo "  跳过，稍后请手动写入 $MCP_SERVER_DIR/.csrf-token"
+  fi
+else
+  echo "  Cookie 已存在，跳过"
+fi
+
+# ---- 3. 安装 i18n Plugin (自动注册 MCP Server + /i18n Skill) ----
+echo ""
+echo "[3/3] 安装 i18n Plugin..."
+
+# 添加 marketplace
+if claude plugin marketplace list 2>&1 | grep -q "camscanner-plugins"; then
+  echo "  Marketplace 已注册，跳过"
+else
+  echo "  注册 marketplace..."
+  claude plugin marketplace add tianmuji/mcp-language-server --sparse plugins .claude-plugin 2>&1
+fi
+
+# 安装插件
+if claude plugin list 2>&1 | grep -q "i18n@camscanner-plugins"; then
+  echo "  Plugin 已安装，跳过"
+else
+  echo "  安装插件..."
+  claude plugin install i18n 2>&1
+fi
+
+# ---- 完成 ----
+echo ""
+echo "==============================="
+echo " 安装完成！请重启 Claude Code"
+echo "==============================="
+echo ""
+echo "使用方式："
+echo "  /i18n 下载          → 自动搜索+集成多语言字符串"
+echo "  /i18n 扫描全能王     → 搜索指定字符串"
+echo ""
+echo "更新 Cookie（过期后）："
+echo "  编辑 $MCP_SERVER_DIR/.cookie"
+echo "  编辑 $MCP_SERVER_DIR/.csrf-token"
+echo ""

package/src/auth.ts

@@ -0,0 +1,158 @@
+import fs from 'fs'
+import path from 'path'
+import os from 'os'
+import { chromium } from 'playwright-core'
+import type { OperateCredentials } from './operate-client.js'
+
+// --- Credentials persistence ---
+
+const CREDS_DIR = path.join(os.homedir(), '.language-mcp')
+const CREDS_FILE = path.join(CREDS_DIR, 'credentials.json')
+
+export async function loadCredentials(): Promise<OperateCredentials | null> {
+  try {
+    if (!fs.existsSync(CREDS_FILE)) return null
+    const data = JSON.parse(fs.readFileSync(CREDS_FILE, 'utf-8'))
+    if (data && data.expiresAt > Date.now()) return data
+    return null
+  } catch {
+    return null
+  }
+}
+
+export async function saveCredentials(creds: OperateCredentials): Promise<void> {
+  if (!fs.existsSync(CREDS_DIR)) fs.mkdirSync(CREDS_DIR, { recursive: true })
+  fs.writeFileSync(CREDS_FILE, JSON.stringify(creds, null, 2))
+}
+
+export async function clearCredentials(): Promise<void> {
+  try { fs.unlinkSync(CREDS_FILE) } catch { /* ignore */ }
+}
+
+// --- Find system Chromium installed by Playwright ---
+
+function findChromium(): string | undefined {
+  const cacheDir = path.join(os.homedir(), 'Library', 'Caches', 'ms-playwright')
+  if (!fs.existsSync(cacheDir)) return undefined
+
+  const dirs = fs.readdirSync(cacheDir)
+    .filter(d => d.startsWith('chromium-'))
+    .sort()
+    .reverse()
+
+  for (const dir of dirs) {
+    const candidates = [
+      path.join(cacheDir, dir, 'chrome-mac-arm64', 'Google Chrome for Testing.app', 'Contents', 'MacOS', 'Google Chrome for Testing'),
+      path.join(cacheDir, dir, 'chrome-mac', 'Google Chrome for Testing.app', 'Contents', 'MacOS', 'Google Chrome for Testing'),
+      path.join(cacheDir, dir, 'chrome-mac-arm64', 'Chromium.app', 'Contents', 'MacOS', 'Chromium'),
+      path.join(cacheDir, dir, 'chrome-mac', 'Chromium.app', 'Contents', 'MacOS', 'Chromium'),
+      path.join(cacheDir, dir, 'chrome-linux', 'chrome'),
+    ]
+    for (const c of candidates) {
+      if (fs.existsSync(c)) return c
+    }
+  }
+  return undefined
+}
+
+// --- Auth config ---
+
+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 async function startSsoLogin(config: SsoConfig): Promise<OperateCredentials> {
+  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.join(CREDS_DIR, 'browser-data')
+  if (!fs.existsSync(userDataDir)) fs.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 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 : '';
+        })()
+      `) as string
+    } 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()
+  }
+}