kiku-agent 1.0.0

package/server/agent/youtubeAuth.js

@@ -0,0 +1,299 @@
+import fs from 'fs';
+import path from 'path';
+import { spawn, execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ENV_PATH = path.resolve(__dirname, '..', '..', '.env');
+const YTDLP_CMD = process.env.KIKU_YTDLP || 'yt-dlp';
+
+const BROWSERS = ['chrome', 'edge', 'brave', 'firefox'];
+
+
+
+function findBrowserExe(browser) {
+  const isWin = process.platform === 'win32';
+  const probes = {
+    chrome: { cmd: isWin ? 'chrome' : 'google-chrome', paths: [
+      'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+      (process.env.LOCALAPPDATA || '') + '\\Google\\Chrome\\Application\\chrome.exe',
+      'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe'
+    ]},
+    edge: { cmd: isWin ? 'msedge' : 'microsoft-edge', paths: [
+      'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
+      'C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe'
+    ]},
+    brave: { cmd: isWin ? 'brave' : 'brave-browser', paths: [
+      'C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe',
+      (process.env.LOCALAPPDATA || '') + '\\BraveSoftware\\Brave-Browser\\Application\\brave.exe'
+    ]},
+    firefox: { cmd: isWin ? 'firefox' : 'firefox', paths: [
+      'C:\\Program Files\\Mozilla Firefox\\firefox.exe',
+      (process.env.LOCALAPPDATA || '') + '\\Mozilla Firefox\\firefox.exe'
+    ]}
+  };
+  const p = probes[browser];
+  if (!p) return null;
+  try { execSync(isWin ? `where ${p.cmd}` : `which ${p.cmd}`, { stdio: 'ignore', windowsHide: true }); return p.cmd; } catch {}
+  if (isWin) {
+    for (const fp of p.paths) { if (fs.existsSync(fp)) return fp; }
+  }
+  return null;
+}
+
+function detectBrowsers() {
+  return BROWSERS.filter(b => findBrowserExe(b) !== null);
+}
+
+function openBrowser(url, browser) {
+  const exe = browser ? findBrowserExe(browser) : null;
+  const isWin = process.platform === 'win32';
+  try {
+    if (exe) {
+      spawn(exe, [url], { windowsHide: true, stdio: 'ignore' });
+    } else if (isWin) {
+      spawn('cmd', ['/c', 'start', '', url], { windowsHide: true, stdio: 'ignore' });
+    } else if (process.platform === 'darwin') {
+      spawn('open', [url], { stdio: 'ignore' });
+    } else {
+      spawn('xdg-open', [url], { stdio: 'ignore' });
+    }
+  } catch (err) {
+    console.error(`  [WARNING] Failed to open browser: ${err.message}`);
+  }
+}
+
+
+
+function loadEnv() {
+  try {
+    if (!fs.existsSync(ENV_PATH)) return;
+    const text = fs.readFileSync(ENV_PATH, 'utf8');
+    for (const line of text.split('\n')) {
+      const m = line.match(/^\s*([\w.-]+)\s*=\s*(.*)\s*$/);
+      if (!m) continue;
+      const key = m[1];
+      let val = m[2].replace(/^["']|["']$/g, '');
+      if (process.env[key] === undefined) process.env[key] = val;
+    }
+  } catch {}
+}
+
+function readEnvMap() {
+  const map = {};
+  try {
+    if (!fs.existsSync(ENV_PATH)) return map;
+    const text = fs.readFileSync(ENV_PATH, 'utf8');
+    for (const line of text.split('\n')) {
+      const m = line.match(/^\s*([\w.-]+)\s*=\s*(.*)\s*$/);
+      if (m) map[m[1]] = m[2].replace(/^["']|["']$/g, '');
+    }
+  } catch {}
+  return map;
+}
+
+
+function writeEnv(updates) {
+  const map = readEnvMap();
+  Object.assign(map, updates);
+  const out = Object.entries(map).map(([k, v]) => `${k}=${v}`).join('\n') + '\n';
+  fs.writeFileSync(ENV_PATH, out, 'utf8');
+}
+
+
+function hasSession(browser) {
+  return new Promise((resolve) => {
+    const timeoutMs = 12000;
+    const args = [
+      '--cookies-from-browser', browser,
+      '--print', '%(title)s',
+      '--no-warnings',
+      '--no-check-certificates',
+      'ytsearch1:Ju Jingyi'
+    ];
+    const p = spawn(YTDLP_CMD, args, {
+      windowsHide: true,
+      stdio: ['ignore', 'pipe', 'pipe']
+    });
+
+    let out = '';
+    let err = '';
+    let resolved = false;
+
+    const timer = setTimeout(() => {
+      if (!resolved) {
+        resolved = true;
+        try { p.kill('SIGKILL'); } catch {}
+        resolve(false);
+      }
+    }, timeoutMs);
+
+    p.stdout.on('data', d => { out += d.toString(); });
+    p.stderr.on('data', d => { err += d.toString(); });
+    p.on('error', () => { if (!resolved) { resolved = true; clearTimeout(timer); resolve(false); } });
+    p.on('close', (code) => {
+      if (resolved) return;
+      resolved = true;
+      clearTimeout(timer);
+      const title = out.trim();
+      const blocked = /403|Forbidden|Sign in|confirm you'?re not a bot|Login Required|Private Video/i.test(err);
+      resolve(code === 0 && title.length > 0 && !blocked);
+    });
+  });
+}
+
+
+
+let _ensured = null;
+let _lastFailTime = 0;
+const RETRY_COOLDOWN_MS = 30000; 
+
+
+export async function ensureYouTubeCookies(opts = {}) {
+ 
+  if (_ensured && _ensured.ok) return _ensured;
+  if (_ensured && !_ensured.ok && (Date.now() - _lastFailTime) < RETRY_COOLDOWN_MS && !opts.force) {
+    return _ensured;
+  }
+
+  loadEnv();
+
+  
+  if (process.env.KIKU_YT_COOKIES && fs.existsSync(process.env.KIKU_YT_COOKIES)) {
+    _ensured = { ok: true, source: 'file', cookiesPath: process.env.KIKU_YT_COOKIES };
+    return _ensured;
+  }
+
+ 
+  const available = detectBrowsers();
+  if (!available.length) {
+    _ensured = { ok: false, reason: 'no-browser', detail: 'No supported browser found (Chrome, Edge, Brave, Firefox)' };
+    _lastFailTime = Date.now();
+    return _ensured;
+  }
+
+ 
+  const preferred = process.env.KIKU_YT_BROWSER;
+  const candidates = preferred && available.includes(preferred)
+    ? [preferred, ...available.filter(b => b !== preferred)]
+    : available;
+
+  for (const b of candidates) {
+    if (await hasSession(b)) {
+    
+      writeEnv({ KIKU_YT_BROWSER: b });
+      process.env.KIKU_YT_BROWSER = b;
+      _ensured = { ok: true, source: 'existing-session', browser: b };
+      return _ensured;
+    }
+  }
+
+ 
+  if (opts.silent) {
+    _ensured = { ok: false, reason: 'no-session', available: candidates };
+    _lastFailTime = Date.now();
+    return _ensured;
+  }
+
+  
+  const loginBrowser = candidates[0];
+  const loginUrl = 'https://accounts.google.com/ServiceLogin?service=youtube&continue=https://www.youtube.com/';
+  openBrowser(loginUrl, loginBrowser);
+
+  console.log(`\n  YouTube Login Required`);
+  console.log(`     A browser (${loginBrowser}) has been opened for you to sign in to YouTube.`);
+  console.log(`     Please complete the login, then come back here.`);
+  console.log(`     Waiting for session... (timeout: ${Math.round((opts.timeout || 120000) / 1000)}s)\n`);
+
+  await new Promise(r => setTimeout(r, 2000));
+
+  const deadline = Date.now() + (opts.timeout || 120000);
+  const pollInterval = 3000;
+  let attempt = 0;
+
+  while (Date.now() < deadline) {
+    attempt++;
+    const remaining = Math.round((deadline - Date.now()) / 1000);
+    process.stdout.write(`\r     Checking... (attempt ${attempt}, ${remaining}s remaining) `);
+
+    for (const b of available) {
+      if (await hasSession(b)) {
+        writeEnv({ KIKU_YT_BROWSER: b });
+        process.env.KIKU_YT_BROWSER = b;
+        process.stdout.write('\r' + ' '.repeat(60) + '\r');
+        console.log(`  [OK] YouTube session detected in ${b}.`);
+        console.log(`     Saved KIKU_YT_BROWSER=${b} to .env\n`);
+        _ensured = { ok: true, source: 'new-session', browser: b };
+        return _ensured;
+      }
+    }
+
+    await new Promise(r => setTimeout(r, pollInterval));
+  }
+
+  process.stdout.write('\r' + ' '.repeat(60) + '\r');
+  console.log(`  [ERROR] Login timed out. You can retry by running the /login command.\n`);
+  _ensured = { ok: false, reason: 'login-timeout' };
+  _lastFailTime = Date.now();
+  return _ensured;
+}
+
+
+export async function exportCookiesToFile() {
+  loadEnv();
+
+  const available = detectBrowsers();
+  const preferred = process.env.KIKU_YT_BROWSER;
+  const candidates = preferred && available.includes(preferred)
+    ? [preferred, ...available.filter(b => b !== preferred)]
+    : available;
+
+  for (const b of candidates) {
+    const cookiesPath = path.resolve(__dirname, '..', '..', '.kiku_yt_cookies.txt');
+    try {
+      const args = [
+        '--cookies-from-browser', b,
+        '--cookies', cookiesPath,
+        '--no-warnings',
+        '--skip-download',
+        'ytsearch1:__export_test__'
+      ];
+      await new Promise((resolve, reject) => {
+        const p = spawn(YTDLP_CMD, args, { windowsHide: true, stdio: ['ignore', 'ignore', 'pipe'] });
+        let err = '';
+        p.stderr.on('data', d => { err += d.toString(); });
+        p.on('error', reject);
+        p.on('close', code => {
+          if (code === 0 && fs.existsSync(cookiesPath)) {
+            resolve();
+          } else {
+            reject(new Error(err || `yt-dlp exited ${code}`));
+          }
+        });
+      });
+
+      writeEnv({ KIKU_YT_COOKIES: cookiesPath });
+      process.env.KIKU_YT_COOKIES = cookiesPath;
+      return { ok: true, browser: b, cookiesPath };
+    } catch {}
+  }
+
+  return { ok: false, reason: 'export-failed' };
+}
+
+export function resetCookieCheck() {
+  _ensured = null;
+  _lastFailTime = 0;
+}
+
+export function getCookieStatus() {
+  return {
+    ensured: _ensured,
+    envBrowser: process.env.KIKU_YT_BROWSER || null,
+    envCookies: process.env.KIKU_YT_COOKIES || null,
+    envPath: ENV_PATH
+  };
+}
+
+
+loadEnv();

package/server/mcp/claude-desktop-config.example.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "kiku-mcp": {
+      "command": "kiku-mcp",
+      "args": [],
+      "description": "Ju Jingyi (Kiku) Fan Portal MCP Server — Filmography, Discography, Gallery, Timeline, Awards, Brands, and Career Data via MCP protocol."
+    }
+  }
+}

package/server/mcp/data/awards.js

@@ -0,0 +1,14 @@
+export const awardsData = [
+  { id: "aw-2024-weibo", year: 2024, title: "Popular Actress of the Year", titleCn: "年度人气女演员", ceremony: "Weibo TV & Internet Video Summit 2024", work: "In Blossom", category: "Acting" },
+  { id: "aw-2023-weibo-night", year: 2023, title: "Influential Figure of the Year", titleCn: "年度影响力艺人", ceremony: "Weibo Night 2023", work: "Beauty of Resilience", category: "Honor" },
+  { id: "aw-2022-erc", year: 2022, title: "Popular Singer of the Year", titleCn: "年度最佳人气歌手", ceremony: "29th ERC Chinese Top Ten Awards", work: "Single '0.2s'", category: "Music" },
+  { id: "aw-2021-tencent", year: 2021, title: "Outstanding Actress of the Year", titleCn: "年度卓越女演员", ceremony: "Tencent Video Starlight Awards 2021", work: "Rebirth for You", category: "Acting" },
+  { id: "aw-2020-erc", year: 2020, title: "Best Stage Performance", titleCn: "最佳舞台表演", ceremony: "27th ERC Chinese Top Ten Awards", work: "Live Stage Performances", category: "Music" },
+  { id: "aw-2020-iqiyi", year: 2020, title: "Breakthrough Actress of the Year", titleCn: "年度突破女演员", ceremony: "iQIYI Scream Night 2020", work: "In a Class of Her Own", category: "Acting" },
+  { id: "aw-2019-qq", year: 2019, title: "Drama Actress of the Year", titleCn: "年度电视剧女演员", ceremony: "iQIYI Scream Night 2019", work: "The Legend of White Snake", category: "Acting" },
+  { id: "aw-2018-weibo", year: 2018, title: "Breakthrough Actress of the Year", titleCn: "年度突破女演员", ceremony: "Weibo TV & Internet Video Summit 2018", work: "Legend of Yunxi", category: "Acting" },
+  { id: "aw-2017-snh48", year: 2017, title: "SNH48 General Election Champion (2nd consecutive)", titleCn: "SNH48总选举冠军（蝉联）", ceremony: "SNH48 4th General Election", work: "SNH48", category: "Honor" },
+  { id: "aw-2016-snh48", year: 2016, title: "SNH48 General Election Champion", titleCn: "SNH48总选举冠军", ceremony: "SNH48 3rd General Election", work: "SNH48", category: "Honor" },
+  { id: "aw-2015-snh48", year: 2015, title: "SNH48 General Election Runner-up", titleCn: "SNH48总选举亚军", ceremony: "SNH48 2nd General Election", work: "SNH48", category: "Honor" },
+  { id: "aw-2014-snh48", year: 2014, title: "SNH48 General Election 4th Place", titleCn: "SNH48总选举第4名", ceremony: "SNH48 1st General Election", work: "SNH48", category: "Honor" },
+];

package/server/mcp/data/brands.js

@@ -0,0 +1,9 @@
+export const brandsData = [
+  { id: "prsr", year: 2026, brandNameEn: "PRSR / Pasha", brandNameCn: "帕莎眼镜", title: "Global Brand Ambassador", category: "Luxury Eyewear", isGlobal: true, highlight: "Milan Fashion Week 2026 debut, viral pink sequin look" },
+  { id: "fred", year: 2026, brandNameEn: "FRED Jewelry", brandNameCn: "FRED珠宝", title: "Brand Ambassador", category: "Luxury Jewelry", isGlobal: false, highlight: "Force 10 High Jewelry editorial for PORT Magazine" },
+  { id: "tutucare", year: 2025, brandNameEn: "TuTuCare", brandNameCn: "凸凸棉", title: "Brand Ambassador", category: "Baby Care", isGlobal: false, highlight: "20,000 gift boxes sold out in 1 second, GMV 10.3M CNY in 1 hour" },
+  { id: "dafuyan", year: 2025, brandNameEn: "DAFUYAN", brandNameCn: "达肤妍", title: "Brand Ambassador", category: "Skincare", isGlobal: false, highlight: "10,000 sets sold out in 8 minutes, 20M CNY in 24 hours" },
+  { id: "lafang", year: 2025, brandNameEn: "Lafang", brandNameCn: "拉芳", title: "Global Brand Ambassador", category: "Hair Care", isGlobal: true, highlight: "First Global Ambassador in brand's 30-year history" },
+  { id: "oppo", year: 2024, brandNameEn: "OPPO", brandNameCn: "OPPO", title: "Brand Ambassador", category: "Technology", isGlobal: false, highlight: "Smartphone campaign across Asia" },
+  { id: "loreal", year: 2024, brandNameEn: "L'Oréal Paris", brandNameCn: "巴黎欧莱雅", title: "Brand Ambassador", category: "Beauty", isGlobal: true, highlight: "Global beauty ambassador for L'Oréal Paris" },
+];

package/server/mcp/data/discography.js

@@ -0,0 +1,36 @@
+export const discographyData = [
+  { id: "find-the-way", titleEn: "FIND THE WAY", titleCn: "FIND THE WAY", year: 2026, category: "single", duration: "3:30", youtubeId: "9AeErG03SZw" },
+  { id: "set-fire", titleEn: "Set Fire to the Silent World", titleCn: "着火的沉默世界", year: 2026, category: "ost", duration: "3:55", youtubeId: "7FXGhAmHIAo", work: "Wanhua Sin" },
+  { id: "not-suffering", titleEn: "Not Suffering", titleCn: "不苦", year: 2026, category: "ost", duration: "3:50", youtubeId: "DafSXZZo9AI", work: "Veil of Shadows" },
+  { id: "eternal-fragrance-song", titleEn: "The Eternal Fragrance", titleCn: "千香", year: 2026, category: "ost", duration: "3:46", youtubeId: "vIanAvWb_HU", work: "The Eternal Fragrance" },
+  { id: "rain-love", titleEn: "Yu Ai (Rain Love)", titleCn: "雨爱", year: 2026, category: "cover", duration: "4:10", youtubeId: "OMLpNyp8T7Q" },
+  { id: "rosa", titleEn: "Rosa", titleCn: "Rosa", year: 2025, category: "single", duration: "3:20", youtubeId: "jZDzOLbd9OU" },
+  { id: "sleepless-sunset", titleEn: "Sleepless Sunset", titleCn: "落日未眠", year: 2025, category: "single", duration: "3:45", youtubeId: "mYYD2JqZ1tE" },
+  { id: "fall", titleEn: "Fall", titleCn: "落", year: 2024, category: "single", duration: "3:36", youtubeId: "8Nh4ZPhYKEc" },
+  { id: "view-from-wall", titleEn: "View From The Wall", titleCn: "壁上观", year: 2024, category: "single", duration: "3:50", youtubeId: "Lge5XhVl9Fc" },
+  { id: "ru-sha", titleEn: "Ru Sha", titleCn: "如纱", year: 2024, category: "ost", duration: "3:42", youtubeId: "lzDP2MfP3eA", work: "Sword and Fairy 4" },
+  { id: "in-blossom-ost", titleEn: "In Blossom Main Theme", titleCn: "花间令", year: 2024, category: "ost", youtubeId: null, work: "In Blossom" },
+  { id: "thoughts-of-joy", titleEn: "Thoughts of Joy", titleCn: "念思凡", year: 2023, category: "ost", duration: "4:05", youtubeId: "D-vEPdasbLo", work: "Beauty of Resilience" },
+  { id: "dew-before-dawn", titleEn: "Dew Before Dawn", titleCn: "露珠在晨曦前消散", year: 2023, category: "ost", youtubeId: null, work: "Beauty of Resilience" },
+  { id: "0.2s", titleEn: "0.2s", titleCn: "0.2s", year: 2022, category: "single", duration: "3:20", youtubeId: null },
+  { id: "mo-li", titleEn: "Mo Li", titleCn: "莫离", year: 2021, category: "ost", duration: "4:12", youtubeId: "7VSAArsR-go", work: "Rebirth for You" },
+  { id: "qing-cheng-shan-xia", titleEn: "Qing Cheng Shan Xia", titleCn: "青城山下", year: 2021, category: "single", youtubeId: null },
+  { id: "fu-rong", titleEn: "Fu Rong", titleCn: "芙蓉", year: 2020, category: "ost", duration: "3:58", youtubeId: "9ke3efb9U7A", work: "The Blooms at Ruyi Pavilion" },
+  { id: "ancient-painting", titleEn: "Ancient Painting", titleCn: "古画", year: 2020, category: "ost", youtubeId: null, work: "The Blooms at Ruyi Pavilion" },
+  { id: "thousand-years", titleEn: "A Millennium's Wait", titleCn: "千年等一回", year: 2019, category: "ost", duration: "3:44", youtubeId: "-vf6jU96WI4", work: "The Legend of White Snake" },
+  { id: "du-qing", titleEn: "Du Qing", titleCn: "渡情", year: 2019, category: "ost", youtubeId: null, work: "The Legend of White Snake" },
+  { id: "wudaoying", titleEn: "Wu Dao Ying", titleCn: "舞导演", year: 2019, category: "single", youtubeId: null },
+  { id: "gufeng-shanshui", titleEn: "Gufeng Shanshui", titleCn: "古风山水", year: 2019, category: "single", youtubeId: null },
+  { id: "meng-lu", titleEn: "Meng Lu (Dream Road)", titleCn: "梦路", year: 2018, category: "single", youtubeId: null },
+  { id: "zui-chi-luo", titleEn: "Zui Chi Luo", titleCn: "最赤裸", year: 2018, category: "single", youtubeId: null },
+];
+
+export const musicVideos = [
+  { id: "mv-find-the-way", titleEn: "FIND THE WAY MV", titleCn: "FIND THE WAY", year: 2026, category: "Official MV", youtubeId: "9AeErG03SZw", duration: "3:30" },
+  { id: "mv-not-suffering", titleEn: "Not Suffering MV", titleCn: "不苦", year: 2026, category: "OST MV", youtubeId: "DafSXZZo9AI", duration: "3:50", work: "Veil of Shadows" },
+  { id: "mv-rain-love", titleEn: "Yu Ai (Rain Love) Stage", titleCn: "雨爱", year: 2026, category: "Stage Performance", youtubeId: "OMLpNyp8T7Q", duration: "4:10" },
+  { id: "mv-set-fire", titleEn: "Set Fire to the Silent World MV", titleCn: "着火的沉默世界", year: 2026, category: "OST MV", youtubeId: "7FXGhAmHIAo", duration: "3:55", work: "Wanhua Sin" },
+  { id: "mv-rosa", titleEn: "Rosa MV", titleCn: "Rosa", year: 2025, category: "Official MV", youtubeId: "jZDzOLbd9OU", duration: "3:20" },
+  { id: "mv-fall", titleEn: "Fall MV", titleCn: "落", year: 2024, category: "Official MV", youtubeId: "8Nh4ZPhYKEc", duration: "3:36" },
+  { id: "mv-ru-sha", titleEn: "Ru Sha MV", titleCn: "如纱", year: 2024, category: "OST MV", youtubeId: "lzDP2MfP3eA", duration: "3:42", work: "Sword and Fairy 4" },
+];

package/server/mcp/data/gallery.js

@@ -0,0 +1,25 @@
+export const galleryData = [
+  { id: "gal-port-2026", titleEn: "PORT Magazine September Cover", titleCn: "PORT中文版九月刊封面", category: "fashion-magazine", era: "2026", description: "Desert Haute Couture photoshoot for PORT Magazine Gold Issue. First woman to cover PORT Chinese edition. Wrote the fashion editorial herself." },
+  { id: "gal-fred-jewelry", titleEn: "FRED Force 10 High Jewelry", titleCn: "FRED高级珠宝", category: "fashion-magazine", era: "2026", description: "Editorial shoot featuring FRED Force 10 High Jewelry collection during PORT desert shoot." },
+  { id: "gal-prsr-milan", titleEn: "PRSR Milan Fashion Week", titleCn: "帕莎眼镜米兰时装周", category: "fashion-magazine", era: "2026", description: "Viral look at Milan Fashion Week for PRSR Global Brand Ambassador debut." },
+  { id: "gal-veil-promo", titleEn: "Veil of Shadows Press Conference", titleCn: "月鳞绮纪发布会", category: "event", era: "2026", description: "Cast press conference for Veil of Shadows drama premiere on Youku." },
+  { id: "gal-eternal-fragrance-promo", titleEn: "The Eternal Fragrance Promotional Event", titleCn: "千香宣传活动", category: "event", era: "2026", description: "Promotional event for The Eternal Fragrance with co-star Song Weilong." },
+  { id: "gal-redcarpet-weibo-2025", titleEn: "Weibo Night 2025 Red Carpet", titleCn: "微博之夜红毯", category: "red-carpet", era: "2025", description: "Red carpet appearance at Weibo Night annual gala 2025." },
+  { id: "gal-redcarpet-tencent-2021", titleEn: "Tencent Video Starlight Awards 2021", titleCn: "腾讯视频星光大赏", category: "red-carpet", era: "2021", description: "Red carpet at Tencent Video Starlight Awards where she won Outstanding Actress." },
+  { id: "gal-in-blossom-stills", titleEn: "In Blossom Drama Stills", titleCn: "花间令剧照", category: "drama-stills", era: "2024", description: "Behind-the-scenes and promotional stills from In Blossom dual-role performance." },
+  { id: "gal-sword-fairy-stills", titleEn: "Sword and Fairy 4 Stills", titleCn: "仙剑四剧照", category: "drama-stills", era: "2024", description: "Drama stills featuring iconic red Han Lingsha costume." },
+  { id: "gal-beauty-stills", titleEn: "Beauty of Resilience Stills", titleCn: "花戎剧照", category: "drama-stills", era: "2023", description: "Promotional stills from Beauty of Resilience triple-role performance." },
+  { id: "gal-white-snake-stills", titleEn: "Legend of White Snake Stills", titleCn: "新白娘子传奇剧照", category: "drama-stills", era: "2019", description: "Drama stills as Bai Suzhen in the classic White Snake remake." },
+  { id: "gal-yunxi-stills", titleEn: "Legend of Yunxi Stills", titleCn: "芸汐传剧照", category: "drama-stills", era: "2018", description: "Breakthrough role stills as Han Yunxi." },
+  { id: "gal-wallpaper-2026-1", titleEn: "2026 Desktop Wallpaper — Sakura", titleCn: "2026桌面壁纸·樱花", category: "wallpaper", era: "2026", description: "High-resolution desktop wallpaper with sakura theme." },
+  { id: "gal-wallpaper-2026-2", titleEn: "2026 Desktop Wallpaper — Desert", titleCn: "2026桌面壁纸·沙漠", category: "wallpaper", era: "2026", description: "High-resolution desktop wallpaper from PORT desert shoot." },
+  { id: "gal-wallpaper-2025", titleEn: "2025 Desktop Wallpaper — Rose", titleCn: "2025桌面壁纸·玫瑰", category: "wallpaper", era: "2025", description: "High-resolution desktop wallpaper with rose/garden theme." },
+];
+
+export const galleryCategories = [
+  { id: "fashion-magazine", label: "Fashion & Magazine", count: 3 },
+  { id: "red-carpet", label: "Red Carpet", count: 2 },
+  { id: "event", label: "Events", count: 2 },
+  { id: "drama-stills", label: "Drama Stills", count: 5 },
+  { id: "wallpaper", label: "Wallpapers", count: 3 },
+];

package/server/mcp/data/index.js

@@ -0,0 +1,7 @@
+export { profileData } from './profile.js';
+export { worksData } from './works.js';
+export { discographyData, musicVideos } from './discography.js';
+export { galleryData, galleryCategories } from './gallery.js';
+export { timelineData } from './timeline.js';
+export { awardsData } from './awards.js';
+export { brandsData } from './brands.js';

package/server/mcp/data/profile.js

@@ -0,0 +1,44 @@
+export const profileData = {
+  nameTh: "จวีจิ้งอี",
+  nameEn: "Ju Jingyi",
+  nameCn: "鞠婧祎",
+  pinyin: "Jū Jìngyī",
+  nickname: "Kiku / เสี่ยวจวี (小鞠)",
+  titleBadge: "ไอดอลสาว 4,000 ปี (中国4000年一遇偶像)",
+  englishAliases: "Kiku Ju / Cecilia Ju",
+  motto: "保持热爱，奔赴山海",
+  mottoTranslation: "Maintain your passion and stride boldly toward the mountains and seas.",
+  bioSummary: "Ju Jingyi (鞠婧祎) is a Chinese singer, dancer, and actress. A former SNH48 2nd Generation member (Team NII, debuting 2013), she made history as a two-time General Election champion (2016–2017) and was inducted into the SNH48 Star Hall of Fame. She is now one of China's top independent solo artists and actresses.",
+  details: {
+    birthDate: "June 18, 1994",
+    birthPlace: "Suining, Sichuan, China",
+    height: "159 cm",
+    bloodType: "O",
+    zodiac: "Gemini",
+    education: "Sichuan Conservatory of Music (Attached Middle School) — Classical Violin",
+    debutDate: "November 2, 2013 (SNH48 2nd Gen Team NII)",
+    graduationDate: "December 15, 2017 (SNH48 Star Hall of Fame)",
+    currentStatus: "Solo Artist & Freelance Actress / Ju Jingyi Studio",
+    fandomName: "Miju (蜜橘)",
+    fandomColors: "Crystal Blue & Sakura Pink (#58B2DC & #FAD2E1)",
+  },
+  talents: [
+    { id: "violin", title: "Classical Violin", level: "Advanced (Sichuan Conservatory training)" },
+    { id: "guzheng", title: "Guzheng (古筝)", level: "Intermediate" },
+    { id: "piano", title: "Piano", level: "Intermediate" },
+    { id: "vocal", title: "Vocal / OST Singing", level: "Professional" },
+    { id: "dance", title: "Traditional Chinese Dance", level: "Professional" },
+  ],
+  quotes: [
+    { textCn: "保持热爱，奔赴山海", textEn: "Maintain your passion and stride boldly toward the mountains and seas.", tag: "mindset" },
+    { textCn: "努力是唯一不会背叛你的东西", textEn: "Hard work is the only thing that will never betray you.", tag: "growth" },
+    { textCn: "我想成为那种，不管在什么环境下都能发光的人", textEn: "I want to be the kind of person who shines in any environment.", tag: "mindset" },
+  ],
+  socialMedia: {
+    weibo: "https://weibo.com/jujingyi",
+    douyin: "https://www.douyin.com/user/jujingyi",
+    instagram: "https://www.instagram.com/jujingyi_official",
+    bilibili: "https://space.bilibili.com/jujingyi",
+    youtube: "https://www.youtube.com/@jujingyi",
+  },
+};

package/server/mcp/data/timeline.js

@@ -0,0 +1,16 @@
+export const timelineData = [
+  { id: "debut-2013", year: 2013, title: "SNH48 2nd Generation Debut (Team NII)", titleCn: "SNH48二期生出道", era: "SNH48 Era", summary: "Debuted as member of SNH48 2nd Generation Team NII, performing Theater Goddess (剧场女神) stage. Left school to pursue idol career." },
+  { id: "fame-2014", year: 2014, title: "4th Place General Election & '4000-Year Idol'", titleCn: "总选举第4名·4000年偶像", era: "SNH48 Era", summary: "4th place in 1st General Election. Japanese media dubbed her 'idol who appears once in 4000 years' (中国4000年一遇偶像) — viral across Asia." },
+  { id: "senbatsu-2015", year: 2015, title: "2nd Place General Election & Seine River Unit", titleCn: "总选举亚军·塞纳河组合", era: "SNH48 Era", summary: "Runner-up in 2nd General Election. Member of Seine River (塞纳河) performance unit." },
+  { id: "election-2016", year: 2016, title: "1st General Election Champion", titleCn: "总选举冠军", era: "SNH48 Era", summary: "Won 1st place in SNH48 3rd General Election, becoming center. First of two consecutive championships." },
+  { id: "election-2017", year: 2017, title: "2nd Consecutive Champion & Star Hall of Fame", titleCn: "蝉联冠军·星殿堂", era: "SNH48 Era", summary: "Won 1st place again (2nd consecutive). Inducted into SNH48 Star Hall of Fame. Graduated December 15, 2017." },
+  { id: "fallen-flowers-2017", year: 2017, title: "The Fallen Flowers (热血长安)", titleCn: "热血长安", era: "Solo Career", summary: "First major acting role after SNH48 graduation. Historical mystery drama on Youku as Shangguan Wan'er." },
+  { id: "yunxi-2018", year: 2018, title: "Acting Breakthrough — Legend of Yunxi", titleCn: "芸汐传·演技突破", era: "Solo Career", summary: "Lead role in Legend of Yunxi (芸汐传). Breakthrough as solo actress. Won Breakthrough Actress at Weibo TV & Video Summit." },
+  { id: "white-snake-2019", year: 2019, title: "The Legend of White Snake & Please Give Me Wings", titleCn: "新白娘子传奇·请赐我一双翅膀", era: "Solo Career", summary: "Starred as Bai Suzhen in classic remake. Also appeared in modern crime thriller. Won Drama Actress of the Year." },
+  { id: "ruyi-2020", year: 2020, title: "Ruyi Pavilion & In a Class of Her Own & Eagle Flag", titleCn: "如意芳霏·漂亮书生·天空城II", era: "Solo Career", summary: "Three dramas in one year: The Blooms at Ruyi Pavilion, In a Class of Her Own (male disguise), and Novoland: Eagle Flag. Breakthrough Actress at iQIYI Scream Night." },
+  { id: "rebirth-2021", year: 2021, title: "Rebirth for You & Rising Stardom", titleCn: "嘉南传·星途上升", era: "Solo Career", summary: "Lead in Rebirth for You. Won Outstanding Actress at Tencent Video Starlight Awards. Established as top-tier actress and brand ambassador." },
+  { id: "resilience-2023", year: 2023, title: "Beauty of Resilience & Influential Figure", titleCn: "花戎·影响力人物", era: "Solo Career", summary: "Xianxia drama Beauty of Resilience with triple-role performance. Won Influential Figure of the Year at Weibo Night." },
+  { id: "blossom-2024", year: 2024, title: "In Blossom & Contract Resolution", titleCn: "花间令·合约纷争解决", era: "Solo Career", summary: "Lead in In Blossom (花间令) with acclaimed dual-role. Won Popular Actress of the Year. Resolved contract dispute with Star48/Siba Media. Confirmed independent status." },
+  { id: "brand-2025", year: 2025, title: "Mega Brand Deals & International Expansion", titleCn: "国际品牌代言扩张", era: "Present", summary: "Global brand ambassador roles across luxury and fashion brands. International presence expansion. Solo singles Rosa and Sleepless Sunset released." },
+  { id: "2026-present", year: 2026, title: "Veil of Shadows, Eternal Fragrance, Wanhua Sin & FIND THE WAY", titleCn: "月鳞绮纪·千香·万花世界·FIND THE WAY", era: "Present", summary: "Multiple major 2026 projects: Veil of Shadows (Youku #1), The Eternal Fragrance (Youku S+), Wanhua Sin, solo single FIND THE WAY, special stage Yu Ai (Rain Love). PRSR Global Brand Ambassador debut at Milan Fashion Week." },
+];

package/server/mcp/data/works.js

@@ -0,0 +1,104 @@
+export const worksData = [
+  {
+    id: "veil-of-shadows", titleEn: "Veil of Shadows", titleCn: "月鳞绮纪", year: 2026,
+    category: "historical-drama", role: "Lu Wuyi (露芜衣) — Nine-tailed Fox",
+    roleCn: "露芜衣", episodes: 38, rating: "9.6/10", platform: "Youku",
+    synopsis: "Fantasy epic directed by Guo Jingming. Lu Wuyi, a nine-tailed fox from the Moon Scale Hall, goes undercover to investigate mysterious murders and battles the ancient Nine-Headed Demon (Jiuying).",
+    themeSong: { titleEn: "Not Suffering", titleCn: "不苦", youtubeId: "DafSXZZo9AI" },
+    featured: true, highlights: ["Fastest 10,000 popularity index on Youku (52 hours)", "2 billion+ views on Weibo and Douyin", "Destiny Theme '不苦' duet with Tian Jiarui topped Chinese charts"],
+  },
+  {
+    id: "eternal-fragrance", titleEn: "The Eternal Fragrance", titleCn: "千香", year: 2026,
+    category: "historical-drama", role: "Jiang Lifei / Xiao Bangchui (姜黎非 / 小棒槌)",
+    roleCn: "姜黎非 / 小棒槌", episodes: 33, rating: "9.3/10", platform: "Youku",
+    synopsis: "S+ fantasy drama adapted from novel 《千香百态》. Jiang Lifei enters Chufeng Academy to find her master, meeting Lei Xiuyuan (Song Weilong). They face destiny across three lifetimes.",
+    themeSong: { titleEn: "The Eternal Fragrance", titleCn: "千香", youtubeId: "vIanAvWb_HU" },
+    featured: true, highlights: ["Reunion of popular pairing Ju Jingyi + Song Weilong", "Top-tier VFX and costumes by Youku"],
+  },
+  {
+    id: "wanhua-sin", titleEn: "Wanhua Sin", titleCn: "万花世界", year: 2026,
+    category: "fantasy-drama", role: "Lead Role", platform: "TBA",
+    synopsis: "Upcoming fantasy epic. Promo OST: 'Set Fire to the Silent World' (着火的沉默世界).",
+    themeSong: { titleEn: "Set Fire to the Silent World", titleCn: "着火的沉默世界", youtubeId: "7FXGhAmHIAo" },
+    featured: true,
+  },
+  {
+    id: "in-blossom", titleEn: "In Blossom", titleCn: "花间令", year: 2024,
+    category: "historical-drama", role: "Yang Caiwei / Shangguan Zhi (杨采薇 / 上官芷)",
+    roleCn: "杨采薇 / 上官芷", episodes: 32, rating: "9.5/10", platform: "Youku",
+    synopsis: "Romantic mystery set in ancient China. Yang Caiwei, a woman presumed dead, returns in a new identity to solve mysteries alongside the man who loved her.",
+    featured: true, highlights: ["Popular Actress of the Year — Weibo TV & Video Summit 2024", "Fastest 10,000 popularity index on Youku in 2024", "Acclaimed dual-role performance with contrasting personalities"],
+  },
+  {
+    id: "sword-fairy-4", titleEn: "Sword and Fairy 4", titleCn: "仙剑四", year: 2024,
+    category: "xianxia-drama", role: "Han Lingsha (韩菱纱)",
+    roleCn: "韩菱纱", episodes: 36, rating: "8.9/10", platform: "iQIYI",
+    synopsis: "Adapted from the classic RPG. Han Lingsha, a spirited tomb raider, joins forces with Yun Tianhe on an adventure to save the world.",
+    themeSong: { titleEn: "Ru Sha", titleCn: "如纱", youtubeId: "lzDP2MfP3eA" },
+    highlights: ["Iconic red costume faithful to the game", "#1 trending on iQIYI across China and Southeast Asia"],
+  },
+  {
+    id: "beauty-of-resilience", titleEn: "Beauty of Resilience", titleCn: "花戎", year: 2023,
+    category: "xianxia-drama", role: "Wei Zhi / Sima Wangyue / A Ya (魏枝 / 司马忘月 / 阿涯)",
+    roleCn: "魏枝 / 司马忘月 / 阿涯", episodes: 36, rating: "8.9/10", platform: "iQIYI",
+    synopsis: "Xianxia romance. Wei Zhi, a servant girl deemed unlucky, is actually the reincarnation of the Phoenix. She meets Yan Yue, a sun god disguised as her master.",
+    themeSong: { titleEn: "Thoughts of Joy", titleCn: "念思凡", youtubeId: "D-vEPdasbLo" },
+    highlights: ["Triple-role performance across 3 lifetimes", "8,500+ popularity index on iQIYI in first week"],
+  },
+  {
+    id: "rebirth-for-you", titleEn: "Rebirth for You", titleCn: "嘉南传", year: 2021,
+    category: "historical-drama", role: "Jiang Baoning (姜保宁 / 嘉南郡主)",
+    roleCn: "姜保宁 / 嘉南郡主", episodes: 40, rating: "9.1/10", platform: "Tencent Video",
+    synopsis: "Adapted from novel 《慕南枝》. Princess Jiang Baoning, clever and independent, teams up with soldier Li Qian to navigate court politics.",
+    themeSong: { titleEn: "Mo Li", titleCn: "莫离", youtubeId: "7VSAArsR-go" },
+    highlights: ["Most Popular Actress — Tencent Video Starlight Awards 2021", "Viral bead headdress fashion trend"],
+  },
+  {
+    id: "ruyi-pavilion", titleEn: "The Blooms at Ruyi Pavilion", titleCn: "如意芳霏", year: 2020,
+    category: "historical-drama", role: "Fu Rong (傅容)",
+    roleCn: "傅容", episodes: 40, rating: "9.2/10", platform: "iQIYI",
+    synopsis: "Fu Rong, the second daughter of the Fu family, has prophetic dreams. She tries to escape her predicted fate of marrying Prince Su, but finds love instead.",
+    themeSong: { titleEn: "Fu Rong", titleCn: "芙蓉", youtubeId: "9ke3efb9U7A" },
+    highlights: ["Reunion of Legend of Yunxi pairing", "#1 on iQIYI in 10+ Asian countries"],
+  },
+  {
+    id: "in-a-class-of-her-own", titleEn: "In a Class of Her Own", titleCn: "漂亮书生", year: 2020,
+    category: "historical-drama", role: "Xue Wenxi / Wen Bin (雪文曦 / 文彬)",
+    roleCn: "雪文曦 / 文彬", episodes: 36, rating: "8.8/10", platform: "iQIYI",
+    synopsis: "Romantic comedy. Xue Wenxi disguises herself as a man to earn a living, accidentally entering an all-male academy where she forms the 'Four Scholars of Yunshang'.",
+    highlights: ["Breakthrough Actress — iQIYI Scream Night 2020", "Iconic male-disguise look went viral across Asia"],
+  },
+  {
+    id: "legend-of-white-snake", titleEn: "The Legend of White Snake", titleCn: "新白娘子传奇", year: 2019,
+    category: "fantasy-drama", role: "Bai Suzhen (白素贞)",
+    roleCn: "白素贞", episodes: 36, rating: "9.3/10", platform: "iQIYI",
+    synopsis: "Modern retelling of the classic Chinese legend. Bai Suzhen, a white snake spirit, falls in love with mortal scholar Xu Xian and opens a medical clinic.",
+    themeSong: { titleEn: "A Millennium's Wait", titleCn: "千年等一回", youtubeId: "-vf6jU96WI4" },
+    highlights: ["Drama Actress of the Year — iQIYI Scream Night 2019", "Official remake of the 1992 classic, aired in 10+ countries"],
+  },
+  {
+    id: "please-give-me-wings", titleEn: "Please Give Me a Pair of Wings", titleCn: "请赐我一双翅膀", year: 2019,
+    category: "modern-drama", role: "Lin Jiuge (林九歌)",
+    roleCn: "林九歌", episodes: 60, platform: "iQIYI",
+    synopsis: "A modern crime thriller. Lin Jiuge is wrongly imprisoned and must fight to prove her innocence while uncovering a larger conspiracy.",
+  },
+  {
+    id: "legend-of-yunxi", titleEn: "Legend of Yunxi", titleCn: "芸汐传", year: 2018,
+    category: "historical-drama", role: "Han Yunxi (韩芸汐)",
+    roleCn: "韩芸汐", episodes: 48, rating: "9.0/10", platform: "iQIYI",
+    synopsis: "Breakthrough role. A talented female physician navigates palace intrigue and romance with Prince Long Feiye.",
+    featured: true, highlights: ["Breakthrough Actress — Weibo TV & Video Summit 2018", "Launched Ju Jingyi to top-tier actress status"],
+  },
+  {
+    id: "the-fallen-flowers", titleEn: "The Fallen Flowers", titleCn: "热血长安", year: 2017,
+    category: "historical-drama", role: "Shangguan Wan'er (上官婉儿)",
+    roleCn: "上官婉儿", episodes: 48, platform: "Youku",
+    synopsis: "Historical mystery drama set in the Tang Dynasty. Shangguan Wan'er solves cases alongside a team of investigators.",
+  },
+  {
+    id: "novoland-eagle-flag", titleEn: "Novoland: Eagle Flag", titleCn: "九州·天空城II", year: 2020,
+    category: "fantasy-drama", role: "Feng Ruotong (风如澈)",
+    roleCn: "风如澈", episodes: 34, platform: "Tencent Video",
+    synopsis: "Fantasy sequel. Feng Ruotong, a spirited girl, discovers her destiny in a world of warring fantasy kingdoms.",
+  },
+];