@nado-language/mcp 0.1.8 → 0.1.10

package/README.md

@@ -6,7 +6,7 @@ This stdio MCP server lets AI chat clients save and practice Nado Language study
 
 - `nado_whoami`: validates the configured Nado account.
 - `nado_save_flashcard`: saves a structured flashcard generated by the user's chat AI. Nado does not call AI for this path.
-- `nado_save_study_item`: alias of `nado_save_flashcard` for natural memorization requests such as "암기할래", "외울래", "암기장에 넣어줘", and "단어장에 추가".
+- `nado_save_study_item`: alias of `nado_save_flashcard` for natural memorization requests such as "hi 를 단어장에 저장해줘", "암기할래", "외울래", "암기장에 넣어줘", and "단어장에 추가".
 - `nado_update_study_item`: updates an existing saved Nado card with a revised meaning, description/explanation, examples, variants, or context. Use it for requests like "hello 설명 추가", "description 추가", "뜻 수정", and "예문 추가".
 - `nado_analyze_and_save_flashcard`: Pro/Admin only. Nado AI generates the learner definition, usage note, examples, and variants, then saves the flashcard.
 - `nado_list_study_items`: loads saved flashcards for the authenticated user.
@@ -16,9 +16,9 @@ The default MCP path is designed to avoid double charging for AI. ChatGPT, Claud
 
 Intent routing:
 
-- If the user provides a new English item and says "나두 암기장", "nado 암기장", "암기할래", "외울래", "암기장에 추가", "단어장에 넣어줘", "remember this", or "add this to my flashcards", use `nado_save_flashcard` or `nado_save_study_item`. Do not create local Markdown files or Google Drive documents for these Nado requests.
+- If the user provides a new English item and says "hi 를 단어장에 저장해줘", "나두 암기장", "nado 암기장", "암기할래", "외울래", "암기장에 추가", "단어장에 넣어줘", "remember this", or "add this to my flashcards", use `nado_save_flashcard` or `nado_save_study_item`. Do not create local Markdown files or Google Drive documents for these Nado requests.
 - If the user asks to add or change description/설명/뜻/예문 on an already saved card, use `nado_update_study_item`.
-- If the user asks to study already saved cards with phrases like "외울래", "암기 연습", "퀴즈 내줘", "쓰기연습", "영작하기", or "복습할래", use `nado_generate_practice`.
+- If the user asks to study already saved cards with phrases like "암기장에 있는 단어로 작문연습하자", "저장된 단어로 작문연습", "외울래", "암기 연습", "퀴즈 내줘", "쓰기연습", "영작하기", or "복습할래", use `nado_generate_practice`. For 작문연습/쓰기연습/영작하기, set `mode` to `writing`.
 - If the user wants to inspect saved items first, use `nado_list_study_items`.
 
 ## Authentication
@@ -136,7 +136,17 @@ export NADO_MCP_AUTH_RELAY_URL='https://language.nado.ai.kr/auth/mcp-callback'
 
 ## Client Registration
 
-Installed package, one-command setup plus browser login:
+Installed package auto-registers the supported local config writers during install/update. It writes Codex Desktop, Claude Desktop, and OpenCode config entries when possible. It does not open browser login during install, and it does not force an already-open AI chat to reload tools.
+
+After install, run browser login once:
+
+```bash
+nado-mcp login
+```
+
+Then fully restart the AI desktop app and start a new chat/session.
+
+Manual one-command setup plus browser login remains available:
 
 ```bash
 nado-mcp connect
@@ -148,6 +158,12 @@ To force every supported local config writer:
 nado-mcp connect all
 ```
 
+To skip install-time auto-registration, install with:
+
+```bash
+NADO_MCP_SKIP_POSTINSTALL=1 npm install --global @nado-language/mcp
+```
+
 Client-specific setup remains available:
 
 ```bash
@@ -161,9 +177,9 @@ For Codex, the command uses the Codex CLI when it is on `PATH`. If the user only
 - macOS/Linux: `~/.codex/config.toml`
 - Windows: `%USERPROFILE%\.codex\config.toml`
 
-Restart Codex Desktop after login completes.
+Restart Codex Desktop after install/login completes.
 If a client was already open, start a new chat/session after restart. Most local MCP clients load tool definitions when the session starts, so a config that was just written may not appear inside an already-running conversation.
-For Codex, confirm the server is active from the chat/TUI with `/mcp`. A server can appear in Settings while still failing to start for the current session.
+For Codex, `/mcp` is an optional diagnostic check to confirm the server is active in the current chat/TUI. Normal users should not need it once install-time registration, login, restart, and new chat have completed. A server can appear in Settings while still failing to start for the current session.
 On Windows, leave the Codex MCP working directory/cwd empty unless it is an existing absolute path. The Nado server does not need a working directory, and a value such as `~/code` can prevent the stdio process from starting if the client does not expand it.
 
 ChatGPT is different: it uses hosted/remote MCP apps configured from ChatGPT Apps settings, not local stdio config files. The local package can prepare local clients such as Codex, Claude Desktop, OpenCode, and generic JSON-based MCP clients.
@@ -269,7 +285,15 @@ npm run mcp:nado:probe -- save-nado-ai "serendipity"
 
 ## Package CLI
 
-Install/register/login flow:
+Install/update auto-registers supported local config writers for Codex Desktop, Claude Desktop, and OpenCode. It does not open browser login during install.
+
+Login flow:
+
+```bash
+nado-mcp login
+```
+
+Manual register/login flow:
 
 ```bash
 nado-mcp connect

package/dist/nado-language-server.mjs

@@ -109,12 +109,12 @@ const tools = [
   },
   {
     name: 'nado_save_flashcard',
-    description: 'Save a structured flashcard to the user\'s Nado Language/Nado 암기장. Use this when the user gives a new English item and asks to memorize/save it, for example "나두 암기장에 추가해줘", "nado 암기장에 넣어줘", "암기장에 추가해줘", "암기할래", "외울래", "단어장에 넣어줘", "remember this", or "add this to my flashcards". Do not create local Markdown files or Google Drive documents for these Nado requests. This does not call Nado AI; the user/chat AI supplies the content quality.',
+    description: 'Save a structured flashcard to the user\'s Nado Language/Nado 암기장. Use this when the user gives a new English item and asks to memorize/save it, for example "hi 를 단어장에 저장해줘", "나두 암기장에 추가해줘", "nado 암기장에 넣어줘", "암기장에 추가해줘", "암기할래", "외울래", "단어장에 넣어줘", "remember this", or "add this to my flashcards". Do not create local Markdown files or Google Drive documents for these Nado requests. This does not call Nado AI; the user/chat AI supplies the content quality.',
     inputSchema: saveFlashcardInputSchema,
   },
   {
     name: 'nado_save_study_item',
-    description: 'Alias of nado_save_flashcard for Nado Language study-list and memorization intents. Prefer this or nado_save_flashcard when the user asks to save a specific word/phrase/sentence to Nado for later memorization, including Korean requests like "나두 암기장", "nado language", "암기할래", "외울래", "암기장에 넣어줘", or "단어장에 추가". Do not answer by editing local files or Drive docs when the user names Nado/Nado MCP. This free path does not call Nado AI.',
+    description: 'Alias of nado_save_flashcard for Nado Language study-list and memorization intents. Prefer this or nado_save_flashcard when the user asks to save a specific word/phrase/sentence to Nado for later memorization, including Korean requests like "hi 를 단어장에 저장해줘", "나두 암기장", "nado language", "암기할래", "외울래", "암기장에 넣어줘", or "단어장에 추가". Do not answer by editing local files or Drive docs when the user names Nado/Nado MCP. This free path does not call Nado AI.',
     inputSchema: saveFlashcardInputSchema,
   },
   {
@@ -156,7 +156,7 @@ const tools = [
   },
   {
     name: 'nado_generate_practice',
-    description: 'Generate English practice content using only the authenticated user saved Nado Language study cards. Use when the user wants to study/review already saved items: "외울래", "암기 연습", "퀴즈 내줘", "쓰기연습", "영작하기", "복습할래", "practice my saved words". If the user supplies a new English item to save, use nado_save_flashcard instead.',
+    description: 'Generate English practice content using only the authenticated user saved Nado Language study cards. Use when the user wants to study/review already saved items: "암기장에 있는 단어로 작문연습하자", "저장된 단어로 작문연습", "외울래", "암기 연습", "퀴즈 내줘", "쓰기연습", "영작하기", "복습할래", "practice my saved words". For 작문연습/쓰기연습/영작하기 requests, use mode "writing". If the user supplies a new English item to save, use nado_save_flashcard instead.',
     inputSchema: {
       type: 'object',
       required: ['mode'],

package/dist/nado-mcp-cli.mjs

@@ -44,6 +44,8 @@ try {
     await runAuth(['logout', ...args]);
   } else if (command === 'auth') {
     await runAuth(args.length > 0 ? args : ['login']);
+  } else if (command === 'postinstall') {
+    runPostinstallAutoSetup();
   } else if (command === 'probe') {
     await runNode(probePath, args, { stdio: 'inherit' });
   } else if (command === 'setup') {
@@ -155,6 +157,40 @@ function setupAllLocalClients(options = {}, flow = {}) {
   return true;
 }
 
+function runPostinstallAutoSetup() {
+  if (process.env.NADO_MCP_SKIP_POSTINSTALL === '1' || process.env.NADO_MCP_NO_AUTO_SETUP === '1') {
+    console.log('Nado MCP postinstall: skipped automatic client registration.');
+    return;
+  }
+
+  try {
+    console.log('Nado MCP postinstall: registering supported local MCP clients.');
+    const registrations = [
+      ['Codex Desktop', () => setupCodexDesktopConfig({ postinstall: true })],
+      ['Claude Desktop', () => setupClaudeDesktop({}, { postinstall: true })],
+      ['OpenCode', () => setupOpenCode({}, { postinstall: true })],
+    ];
+    let registeredCount = 0;
+    for (const [label, register] of registrations) {
+      try {
+        register();
+        registeredCount += 1;
+      } catch (error) {
+        console.warn(`Nado MCP postinstall warning: ${label} registration failed (${error instanceof Error ? error.message : String(error)}).`);
+      }
+    }
+    printToolProbeSummary();
+    if (registeredCount > 0) {
+      console.log('Nado MCP postinstall: registration complete. Run `nado-mcp login` once, then restart the AI app and start a new chat.');
+    } else {
+      console.warn('Nado MCP postinstall warning: no local client config was registered. Run `nado-mcp setup all` manually, or use `nado-mcp config` for a generic MCP client.');
+    }
+  } catch (error) {
+    console.warn(`Nado MCP postinstall warning: automatic registration failed (${error instanceof Error ? error.message : String(error)}).`);
+    console.warn('Run `nado-mcp setup all` manually, or use `nado-mcp config` for a generic MCP client.');
+  }
+}
+
 function setupCodex(flow = {}) {
   const check = spawnSync('codex', ['--version'], { stdio: 'ignore' });
   if (check.error || check.status !== 0) {
@@ -183,7 +219,8 @@ function setupCodexDesktopConfig(flow = {}, reason = '') {
 
   if (reason) console.log(`${reason} Falling back to Codex Desktop config.`);
   console.log(`Registered Nado Language MCP with Codex Desktop: ${configPath}`);
-  if (flow.loginAfter) console.log('Browser login will open next. Restart Codex Desktop after login completes.');
+  if (flow.postinstall) console.log('Restart Codex Desktop or start a new Codex session before expecting Nado tools to appear.');
+  else if (flow.loginAfter) console.log('Browser login will open next. Restart Codex Desktop after login completes.');
   else console.log('Restart Codex Desktop, then run `nado-mcp login`.');
 }
 
@@ -200,7 +237,8 @@ function setupClaudeDesktop(options = {}, flow = {}) {
 
   writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`);
   console.log(`Registered Nado Language MCP with Claude Desktop: ${configPath}`);
-  if (flow.loginAfter) console.log('Browser login will open next. Restart Claude Desktop after login completes.');
+  if (flow.postinstall) console.log('Restart Claude Desktop before expecting Nado tools to appear.');
+  else if (flow.loginAfter) console.log('Browser login will open next. Restart Claude Desktop after login completes.');
   else console.log('Restart Claude Desktop, then run `nado-mcp login`.');
 }
 
@@ -253,6 +291,10 @@ async function doctor() {
   console.log(`Auth refresh token: ${auth.refreshToken ? 'present' : 'missing'}`);
   console.log(`Auth email/password fallback: ${auth.email ? `configured for ${auth.email}` : 'missing'}`);
   console.log(`Codex Desktop config: ${registrationText(codex)}`);
+  if (codex.issues?.length) {
+    console.log('Codex Desktop config issues:');
+    for (const issue of codex.issues) console.log(`  - ${issue}`);
+  }
   console.log(`Claude Desktop config: ${registrationText(claude)}`);
   console.log(`OpenCode config: ${registrationText(opencode)}`);
   console.log('');
@@ -329,13 +371,93 @@ function codexRegistrationStatus() {
 
   try {
     const text = readFileSync(configPath, 'utf8');
-    const sectionPattern = new RegExp(`^\\s*\\[mcp_servers\\.${escapeRegExp(serverName)}]\\s*$`, 'm');
-    return { path: configPath, fileExists: true, registered: sectionPattern.test(text) };
+    const sectionText = readTomlSection(text, `mcp_servers.${serverName}`);
+    const registered = Boolean(sectionText);
+    const issues = registered ? codexMcpSectionIssues(sectionText) : [];
+    return { path: configPath, fileExists: true, registered, issues };
   } catch (error) {
     return { path: configPath, fileExists: true, registered: false, error: error instanceof Error ? error.message : String(error) };
   }
 }
 
+function readTomlSection(text, sectionName) {
+  const target = String(sectionName || '').trim();
+  const lines = String(text || '').split(/\r?\n/);
+  const output = [];
+  let inSection = false;
+
+  for (const line of lines) {
+    const header = line.match(/^\s*\[([^\]]+)]\s*$/);
+    if (header) {
+      if (inSection) break;
+      inSection = header[1] === target;
+      continue;
+    }
+    if (inSection) output.push(line);
+  }
+
+  return inSection ? output.join('\n') : '';
+}
+
+function codexMcpSectionIssues(sectionText) {
+  const issues = [];
+  const command = tomlStringValue(sectionText, 'command');
+  const cwd = tomlStringValue(sectionText, 'cwd');
+  const args = tomlArrayValue(sectionText, 'args');
+
+  if (!command) {
+    issues.push('Missing command. Codex cannot start a stdio MCP server without command.');
+  } else if (path.isAbsolute(command) && !existsSync(command)) {
+    issues.push(`Command path does not exist: ${command}`);
+  }
+
+  if (!Array.isArray(args) || args.length === 0) {
+    issues.push('Missing args. Expected the Nado server script path in args.');
+  } else {
+    const serverArg = args[0];
+    if (typeof serverArg === 'string' && path.isAbsolute(serverArg) && !existsSync(serverArg)) {
+      issues.push(`Server script path does not exist: ${serverArg}`);
+    }
+  }
+
+  if (cwd) {
+    const expandedCwd = expandHome(cwd);
+    const exists = existsSync(expandedCwd);
+    const detail = exists ? `configured as ${cwd}` : `configured as ${cwd}, which does not exist on this machine`;
+    issues.push(`Remove Working directory/cwd unless required; Nado MCP does not need it (${detail}).`);
+  }
+
+  return issues;
+}
+
+function tomlRawValue(sectionText, key) {
+  const pattern = new RegExp(`^\\s*${escapeRegExp(key)}\\s*=\\s*(.+?)\\s*$`, 'm');
+  return sectionText.match(pattern)?.[1]?.trim() || '';
+}
+
+function tomlStringValue(sectionText, key) {
+  const raw = tomlRawValue(sectionText, key);
+  if (!raw) return '';
+  try {
+    const parsed = JSON.parse(raw);
+    return typeof parsed === 'string' ? parsed : '';
+  } catch {
+    const singleQuoted = raw.match(/^'([^']*)'$/);
+    return singleQuoted ? singleQuoted[1] : '';
+  }
+}
+
+function tomlArrayValue(sectionText, key) {
+  const raw = tomlRawValue(sectionText, key);
+  if (!raw) return null;
+  try {
+    const parsed = JSON.parse(raw);
+    return Array.isArray(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
 function jsonRegistrationStatus(configPath, keyPath) {
   if (!existsSync(configPath)) return { path: configPath, fileExists: false, registered: false };
 
@@ -785,6 +907,7 @@ function codexDesktopConfigPath() {
 }
 
 function claudeDesktopConfigPath() {
+  if (process.env.NADO_MCP_CLAUDE_CONFIG_FILE) return expandHome(process.env.NADO_MCP_CLAUDE_CONFIG_FILE);
   if (process.platform === 'win32') {
     return path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
   }
@@ -828,6 +951,7 @@ function printHelp() {
   console.log(`Nado Language MCP
 
 Usage:
+  nado-mcp login                      Open browser login and save local auth
   nado-mcp connect                    Auto-register detected local MCP clients, then log in
   nado-mcp connect all                Register all supported local config writers, then log in
   nado-mcp connect codex              Register in Codex CLI/Desktop, then log in
@@ -836,7 +960,6 @@ Usage:
   nado-mcp setup <client>             Register without login
   nado-mcp setup mcp-json --file PATH Merge into a generic mcpServers JSON file
   nado-mcp config                     Print generic MCP config snippets
-  nado-mcp login                      Open browser login and save local auth
   nado-mcp status                     Show local auth status
   nado-mcp logout                     Remove local auth tokens
   nado-mcp server                     Start the stdio MCP server
@@ -852,8 +975,9 @@ Universal fallback:
   nado-mcp config
 
 AI-agent friendly flow:
-  1. Install the package
-  2. Run: nado-mcp connect
-  3. If the client is unknown or remote-only, paste the JSON from nado-mcp config
+  1. Install the package; install/update auto-registers Codex Desktop, Claude Desktop, and OpenCode
+  2. Run: nado-mcp login
+  3. Fully restart the AI app and start a new chat/session
+  4. If the client is unknown or remote-only, paste the JSON from nado-mcp config
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nado-language/mcp",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Nado Language MCP server for saving AI-generated English flashcards and practicing saved materials.",
   "type": "module",
   "private": false,
@@ -19,6 +19,7 @@
   },
   "scripts": {
     "prepack": "node ../../scripts/build-nado-mcp-package.mjs",
+    "postinstall": "node dist/nado-mcp-cli.mjs postinstall",
     "test": "node dist/nado-mcp-cli.mjs doctor"
   },
   "keywords": [