@nado-language/mcp 0.1.7 → 0.1.9

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
@@ -163,6 +163,8 @@ For Codex, the command uses the Codex CLI when it is on `PATH`. If the user only
 
 Restart Codex Desktop after 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.
+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.
 

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

@@ -30,7 +30,7 @@ const command = process.argv[2] || 'help';
 const args = process.argv.slice(3);
 
 try {
-  if (command === 'help' || command === '--help' || command === '-h') {
+  if (shouldPrintHelp(command, args)) {
     printHelp();
   } else if (command === 'version' || command === '--version' || command === '-v') {
     console.log(packageVersion);
@@ -253,6 +253,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('');
@@ -260,10 +264,12 @@ async function doctor() {
   console.log('A green local server check only proves the stdio server can list tools; it does not prove an already-open chat loaded them.');
   console.log('');
   console.log('If the server check is ok but Nado tools are not visible in the AI app:');
-  console.log('  1. Fully quit and restart the desktop app after `nado-mcp connect`.');
-  console.log('  2. Start a new chat/session; existing sessions may not reload newly added MCP tools.');
-  console.log('  3. Run `nado-mcp status` for auth and `nado-mcp probe list` for local server tools.');
-  console.log('  4. If a chat tries local files or Google Drive for "나두/Nado 암기장", that chat did not load the Nado MCP tools.');
+  console.log('  1. In Codex, run `/mcp` in the chat/TUI and confirm nado-language is active, not only listed in Settings.');
+  console.log('  2. Fully quit and restart the desktop app after `nado-mcp connect`.');
+  console.log('  3. Start a new chat/session; existing sessions may not reload newly added MCP tools.');
+  console.log('  4. On Windows, remove Working directory/cwd unless it is an existing absolute path. The Nado server does not need cwd.');
+  console.log('  5. Run `nado-mcp status` for auth and `nado-mcp probe list` for local server tools.');
+  console.log('  6. If a chat tries local files or Google Drive for "나두/Nado 암기장", that chat did not load the Nado MCP tools.');
 }
 
 function printToolProbeSummary() {
@@ -327,13 +333,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 };
 
@@ -536,6 +622,11 @@ function commandExists(commandName) {
   return !result.error && result.status === 0;
 }
 
+function shouldPrintHelp(currentCommand, currentArgs) {
+  if (currentCommand === 'help' || currentCommand === '--help' || currentCommand === '-h') return true;
+  return currentArgs.includes('--help') || currentArgs.includes('-h');
+}
+
 function codexDesktopTomlSection() {
   const spec = stdioServerSpec();
   return [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nado-language/mcp",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Nado Language MCP server for saving AI-generated English flashcards and practicing saved materials.",
   "type": "module",
   "private": false,