kiku-agent 1.0.0 → 1.0.4

package/server/agent/youtubeAuth.js

@@ -2,41 +2,64 @@ import fs from 'fs';
 import path from 'path';
 import { spawn, execSync } from 'child_process';
 import { fileURLToPath } from 'url';
+import { KIKU_DATA_DIR } from './appPaths.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const ENV_PATH = path.resolve(__dirname, '..', '..', '.env');
+const AUTH_CONFIG_PATH = path.join(KIKU_DATA_DIR, 'yt_auth.json');
+const SECURE_COOKIE_PATH = path.join(KIKU_DATA_DIR, 'cookies.txt');
 const YTDLP_CMD = process.env.KIKU_YTDLP || 'yt-dlp';
 
-const BROWSERS = ['chrome', 'edge', 'brave', 'firefox'];
-
 
+const BROWSERS = ['firefox', 'chrome', 'edge', 'brave'];
 
 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'
-    ]}
+    firefox: {
+      cmd: isWin ? 'firefox' : 'firefox',
+      paths: [
+        'C:\\Program Files\\Mozilla Firefox\\firefox.exe',
+        'C:\\Program Files (x86)\\Mozilla Firefox\\firefox.exe',
+        (process.env.LOCALAPPDATA || '') + '\\Mozilla Firefox\\firefox.exe'
+      ]
+    },
+    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',
+        (process.env.LOCALAPPDATA || '') + '\\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'
+      ]
+    }
   };
+
   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 {}
+  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; }
+    for (const fp of p.paths) {
+      if (fp && fs.existsSync(fp)) return fp;
+    }
   }
   return null;
 }
@@ -63,9 +86,35 @@ function openBrowser(url, browser) {
   }
 }
 
+function readAuthConfig() {
+  try {
+    if (fs.existsSync(AUTH_CONFIG_PATH)) {
+      return JSON.parse(fs.readFileSync(AUTH_CONFIG_PATH, 'utf8')) || {};
+    }
+  } catch {}
+  return {};
+}
 
+function writeAuthConfig(updates) {
+  try {
+    fs.mkdirSync(KIKU_DATA_DIR, { recursive: true });
+    const current = readAuthConfig();
+    const merged = { ...current, ...updates };
+    fs.writeFileSync(AUTH_CONFIG_PATH, JSON.stringify(merged, null, 2), 'utf8');
+  } catch {}
+}
 
 function loadEnv() {
+
+  const userConfig = readAuthConfig();
+  if (userConfig.KIKU_YT_BROWSER && process.env.KIKU_YT_BROWSER === undefined) {
+    process.env.KIKU_YT_BROWSER = userConfig.KIKU_YT_BROWSER;
+  }
+  if (userConfig.KIKU_YT_COOKIES && process.env.KIKU_YT_COOKIES === undefined) {
+    process.env.KIKU_YT_COOKIES = userConfig.KIKU_YT_COOKIES;
+  }
+
+
   try {
     if (!fs.existsSync(ENV_PATH)) return;
     const text = fs.readFileSync(ENV_PATH, 'utf8');
@@ -73,7 +122,7 @@ function loadEnv() {
       const m = line.match(/^\s*([\w.-]+)\s*=\s*(.*)\s*$/);
       if (!m) continue;
       const key = m[1];
-      let val = m[2].replace(/^["']|["']$/g, '');
+      const val = m[2].replace(/^["']|["']$/g, '');
       if (process.env[key] === undefined) process.env[key] = val;
     }
   } catch {}
@@ -92,24 +141,32 @@ function readEnvMap() {
   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');
-}
 
+  for (const [k, v] of Object.entries(updates)) {
+    process.env[k] = v;
+  }
+  writeAuthConfig(updates);
+
+ 
+  try {
+    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');
+  } catch {}
+}
 
 function hasSession(browser) {
   return new Promise((resolve) => {
-    const timeoutMs = 12000;
+    const timeoutMs = 8000;
     const args = [
       '--cookies-from-browser', browser,
       '--print', '%(title)s',
       '--no-warnings',
+      '--no-playlist',
       '--no-check-certificates',
-      'ytsearch1:Ju Jingyi'
+      'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
     ];
     const p = spawn(YTDLP_CMD, args, {
       windowsHide: true,
@@ -128,51 +185,71 @@ function hasSession(browser) {
       }
     }, 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.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);
+      const blocked = /403|Forbidden|Sign in|confirm you'?re not a bot|Login Required|Private Video|database is locked/i.test(err);
       resolve(code === 0 && title.length > 0 && !blocked);
     });
   });
 }
 
-
-
 let _ensured = null;
 let _lastFailTime = 0;
-const RETRY_COOLDOWN_MS = 30000; 
-
+let _inFlightPromise = null;
+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;
   }
 
+ 
+  if (_inFlightPromise) {
+    return _inFlightPromise;
+  }
+
+  _inFlightPromise = (async () => {
+    try {
+      return await _ensureYouTubeCookiesImpl(opts);
+    } finally {
+      _inFlightPromise = null;
+    }
+  })();
+
+  return _inFlightPromise;
+}
+
+async function _ensureYouTubeCookiesImpl(opts = {}) {
   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 };
+ 
+  const cookiesCandidate = process.env.KIKU_YT_COOKIES || (fs.existsSync(SECURE_COOKIE_PATH) ? SECURE_COOKIE_PATH : null);
+  if (cookiesCandidate && fs.existsSync(cookiesCandidate)) {
+    _ensured = { ok: true, source: 'file', cookiesPath: cookiesCandidate };
     return _ensured;
   }
 
  
   const available = detectBrowsers();
   if (!available.length) {
-    _ensured = { ok: false, reason: 'no-browser', detail: 'No supported browser found (Chrome, Edge, Brave, Firefox)' };
+    _ensured = { ok: false, reason: 'no-browser', detail: 'No supported browser found (Firefox, Chrome, Edge, Brave)' };
     _lastFailTime = Date.now();
     return _ensured;
   }
 
- 
   const preferred = process.env.KIKU_YT_BROWSER;
   const candidates = preferred && available.includes(preferred)
     ? [preferred, ...available.filter(b => b !== preferred)]
@@ -180,9 +257,7 @@ export async function ensureYouTubeCookies(opts = {}) {
 
   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;
     }
@@ -195,7 +270,7 @@ export async function ensureYouTubeCookies(opts = {}) {
     return _ensured;
   }
 
-  
+
   const loginBrowser = candidates[0];
   const loginUrl = 'https://accounts.google.com/ServiceLogin?service=youtube&continue=https://www.youtube.com/';
   openBrowser(loginUrl, loginBrowser);
@@ -208,21 +283,24 @@ export async function ensureYouTubeCookies(opts = {}) {
   await new Promise(r => setTimeout(r, 2000));
 
   const deadline = Date.now() + (opts.timeout || 120000);
-  const pollInterval = 3000;
+  const pollInterval = 4000;
   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) `);
+    if (!opts.silent && process.stdout.isTTY) {
+      process.stdout.write(`\r     Checking session... (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');
+        if (process.stdout.isTTY) {
+          process.stdout.write('\r' + ' '.repeat(65) + '\r');
+        }
         console.log(`  [OK] YouTube session detected in ${b}.`);
-        console.log(`     Saved KIKU_YT_BROWSER=${b} to .env\n`);
+        console.log(`     Saved preference (KIKU_YT_BROWSER=${b})\n`);
         _ensured = { ok: true, source: 'new-session', browser: b };
         return _ensured;
       }
@@ -231,14 +309,15 @@ export async function ensureYouTubeCookies(opts = {}) {
     await new Promise(r => setTimeout(r, pollInterval));
   }
 
-  process.stdout.write('\r' + ' '.repeat(60) + '\r');
+  if (process.stdout.isTTY) {
+    process.stdout.write('\r' + ' '.repeat(65) + '\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();
 
@@ -249,22 +328,22 @@ export async function exportCookiesToFile() {
     : available;
 
   for (const b of candidates) {
-    const cookiesPath = path.resolve(__dirname, '..', '..', '.kiku_yt_cookies.txt');
     try {
+      fs.mkdirSync(KIKU_DATA_DIR, { recursive: true });
       const args = [
         '--cookies-from-browser', b,
-        '--cookies', cookiesPath,
+        '--cookies', SECURE_COOKIE_PATH,
         '--no-warnings',
         '--skip-download',
-        'ytsearch1:__export_test__'
+        'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
       ];
       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.stderr?.on('data', d => { err += d.toString(); });
         p.on('error', reject);
         p.on('close', code => {
-          if (code === 0 && fs.existsSync(cookiesPath)) {
+          if (code === 0 && fs.existsSync(SECURE_COOKIE_PATH)) {
             resolve();
           } else {
             reject(new Error(err || `yt-dlp exited ${code}`));
@@ -272,9 +351,8 @@ export async function exportCookiesToFile() {
         });
       });
 
-      writeEnv({ KIKU_YT_COOKIES: cookiesPath });
-      process.env.KIKU_YT_COOKIES = cookiesPath;
-      return { ok: true, browser: b, cookiesPath };
+      writeEnv({ KIKU_YT_COOKIES: SECURE_COOKIE_PATH });
+      return { ok: true, browser: b, cookiesPath: SECURE_COOKIE_PATH };
     } catch {}
   }
 
@@ -284,16 +362,17 @@ export async function exportCookiesToFile() {
 export function resetCookieCheck() {
   _ensured = null;
   _lastFailTime = 0;
+  _inFlightPromise = null;
 }
 
 export function getCookieStatus() {
   return {
     ensured: _ensured,
     envBrowser: process.env.KIKU_YT_BROWSER || null,
-    envCookies: process.env.KIKU_YT_COOKIES || null,
-    envPath: ENV_PATH
+    envCookies: process.env.KIKU_YT_COOKIES || (fs.existsSync(SECURE_COOKIE_PATH) ? SECURE_COOKIE_PATH : null),
+    envPath: ENV_PATH,
+    authConfigPath: AUTH_CONFIG_PATH
   };
 }
 
-
 loadEnv();

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

@@ -1,6 +1,6 @@
 {
   "mcpServers": {
-    "kiku-mcp": {
+    "kiku": {
       "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/discography.js

@@ -1,36 +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" },
-];
+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/dataAdapter.js

@@ -0,0 +1,102 @@
+import { profileData } from '../../src/data/profileData.js';
+import { worksData } from '../../src/data/worksData.js';
+import { discographyData } from '../../src/data/discographyData.js';
+import { musicVideoData } from '../../src/data/musicVideoData.js';
+import { brandsData } from '../../src/data/brandsData.js';
+import { socialUpdatesData } from '../../src/data/socialUpdatesData.js';
+import { galleryData } from '../../src/data/galleryData.js';
+import { awardsData } from '../../src/data/awardsData.js';
+import { timelineData } from '../../src/data/timelineData.js';
+
+export function getUnifiedProfile() {
+  return {
+    ...profileData,
+    nameEn: profileData.nameEn || 'Ju Jingyi',
+    nameCn: profileData.nameCn || '鞠婧祎',
+    nameTh: profileData.nameTh || 'จวีจิ้งอี',
+    fandomName: profileData.fandomName || 'Miju (蜜橘)',
+    slogan: profileData.slogan || '鞠世无双，婧然倾心',
+  };
+}
+
+export function getUnifiedWorks() {
+  return worksData.map(w => ({
+    id: w.id,
+    titleEn: w.titleEn || w.titleTh || w.titleCn,
+    titleCn: w.titleCn,
+    titleTh: w.titleTh,
+    year: w.year,
+    role: w.role,
+    characterName: w.role,
+    genre: w.genre || w.type || 'Drama',
+    featured: Boolean(w.featured),
+    synopsis: w.synopsis || '',
+    platform: w.platform || '',
+  }));
+}
+
+export function getUnifiedDiscography() {
+  const songs = [
+    ...(discographyData.latestReleases || []),
+    ...(discographyData.ostList || []),
+    ...(discographyData.singles || []),
+  ];
+
+  const map = new Map();
+  for (const s of songs) {
+    const key = s.titleCn || s.titleTh || s.titleEn || s.id;
+    if (!map.has(key)) {
+      map.set(key, {
+        id: s.id,
+        titleEn: s.titleEn || s.titleTh || s.titleCn,
+        titleCn: s.titleCn,
+        titleTh: s.titleTh,
+        year: s.year,
+        type: s.type || 'Single',
+        category: s.work ? 'ost' : 'single',
+        work: s.work || null,
+        youtubeId: s.youtubeId || null,
+      });
+    }
+  }
+  return Array.from(map.values()).sort((a, b) => (b.year || 0) - (a.year || 0));
+}
+
+export function getUnifiedAwards() {
+  return awardsData.map(a => ({
+    id: a.id,
+    title: a.title,
+    titleCn: a.titleCn || a.title,
+    year: a.year,
+    ceremony: a.ceremony || a.organization || '',
+    category: a.category || 'General',
+  })).sort((a, b) => (b.year || 0) - (a.year || 0));
+}
+
+export function getUnifiedBrands() {
+  return brandsData.map(b => ({
+    id: b.id,
+    brandNameEn: b.brand || b.nameEn || '',
+    brandNameCn: b.brandCn || b.nameCn || b.brand || '',
+    title: b.title || 'Brand Ambassador',
+    year: b.year,
+    isGlobal: Boolean(b.isGlobal),
+    category: b.category || 'Beauty / Fashion',
+  })).sort((a, b) => (b.year || 0) - (a.year || 0));
+}
+
+export function getUnifiedTimeline() {
+  return timelineData.map(m => ({
+    id: m.id,
+    year: m.year,
+    period: m.period || String(m.year),
+    title: m.title,
+    titleCn: m.titleCn || m.title,
+    description: m.description || '',
+    era: m.era || 'Solo Career',
+  })).sort((a, b) => (b.year || 0) - (a.year || 0));
+}
+
+export function getUnifiedGallery() {
+  return galleryData;
+}

package/server/mcp/examples/claude-code.mcp.example.json

@@ -0,0 +1,19 @@
+{
+  "mcpServers": {
+    "kiku": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "-p", "kiku-agent", "kiku-mcp"],
+      "env": {
+        "KIKU_MCP_ENABLE_WEB_TOOLS": "true"
+      }
+    },
+    "kiku-remote": {
+      "type": "http",
+      "url": "https://jujingyi-kikuuu.vercel.app/mcp",
+      "headers": {
+        "X-API-Key": "YOUR_API_KEY"
+      }
+    }
+  }
+}

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

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "kiku": {
+      "command": "npx",
+      "args": ["-y", "-p", "kiku-agent", "kiku-mcp"],
+      "env": {
+        "KIKU_MCP_ENABLE_WEB_TOOLS": "true"
+      }
+    }
+  }
+}

package/server/mcp/examples/cline.example.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "kiku": {
+      "command": "npx",
+      "args": ["-y", "-p", "kiku-agent", "kiku-mcp"],
+      "env": {
+        "KIKU_MCP_ENABLE_WEB_TOOLS": "true"
+      },
+      "disabled": false,
+      "alwaysAllow": []
+    }
+  }
+}

package/server/mcp/examples/cursor.example.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "kiku": {
+      "command": "npx",
+      "args": ["-y", "-p", "kiku-agent", "kiku-mcp"],
+      "env": {
+        "KIKU_MCP_ENABLE_WEB_TOOLS": "true"
+      }
+    },
+    "kiku-remote": {
+      "url": "https://jujingyi-kikuuu.vercel.app/mcp"
+    }
+  }
+}

package/server/mcp/examples/gemini-cli.example.json

@@ -0,0 +1,17 @@
+{
+  "mcpServers": {
+    "kiku": {
+      "command": "npx",
+      "args": ["-y", "-p", "kiku-agent", "kiku-mcp"],
+      "env": {
+        "KIKU_MCP_ENABLE_WEB_TOOLS": "true"
+      }
+    },
+    "kiku-remote": {
+      "httpUrl": "https://jujingyi-kikuuu.vercel.app/mcp",
+      "headers": {
+        "X-API-Key": "YOUR_API_KEY"
+      }
+    }
+  }
+}