@laomeifun/my-anki-mcp 0.11.0 → 0.11.2

package/bin/ankimcp.js

@@ -1,12 +1,12 @@
-#!/usr/bin/env node
-
-// Check if --stdio flag is present
-const isStdioMode = process.argv.includes('--stdio');
-
-if (isStdioMode) {
-  // STDIO mode - for MCP clients like Cursor, Cline, Zed, etc.
-  require('../dist/main-stdio.js');
-} else {
-  // HTTP mode (default) - for web-based AI assistants
-  require('../dist/main-http.js');
-}
+#!/usr/bin/env node
+
+// Check if --stdio flag is present
+const isStdioMode = process.argv.includes('--stdio');
+
+if (isStdioMode) {
+  // STDIO mode - for MCP clients like Cursor, Cline, Zed, etc.
+  require('../dist/main-stdio.js');
+} else {
+  // HTTP mode (default) - for web-based AI assistants
+  require('../dist/main-http.js');
+}

package/dist/cli.js

@@ -35,40 +35,40 @@ function parseCliArgs() {
         .option("-h, --host <address>", "Host to bind to (HTTP mode)", "127.0.0.1")
         .option("-a, --anki-connect <url>", "AnkiConnect URL", "http://localhost:8765")
         .option("--ngrok", "Start ngrok tunnel (requires global ngrok installation)")
-        .addHelpText("after", `
-Transport Modes:
-  HTTP Mode (default):  For web-based AI assistants (ChatGPT, Claude.ai)
-  STDIO Mode:           For desktop MCP clients (Cursor, Cline, Zed)
-
-Examples - HTTP Mode:
-  $ ankimcp                                    # Use defaults
-  $ ankimcp --port 8080                        # Custom port
-  $ ankimcp --host 0.0.0.0 --port 3000         # Listen on all interfaces
-  $ ankimcp --anki-connect http://localhost:8765
-
-Examples - HTTP Mode with Ngrok:
-  $ ankimcp --ngrok                            # Start with ngrok tunnel
-  $ ankimcp --port 8080 --ngrok                # Custom port + ngrok
-  $ ankimcp --host 0.0.0.0 --ngrok             # Public host + ngrok
-
-Examples - STDIO Mode:
-  $ ankimcp --stdio                            # For use with npx in MCP clients
-
-  # MCP client configuration (Cursor, Cline, Zed, etc.):
-  {
-    "mcpServers": {
-      "anki-mcp": {
-        "command": "npx",
-        "args": ["-y", "ankimcp", "--stdio"]
-      }
-    }
-  }
-
-Ngrok Setup (one-time):
-  1. Install: npm install -g ngrok
-  2. Get auth token from: https://dashboard.ngrok.com/get-started/your-authtoken
-  3. Setup: ngrok config add-authtoken <your-token>
-  4. Run: ankimcp --ngrok
+        .addHelpText("after", `
+Transport Modes:
+  HTTP Mode (default):  For web-based AI assistants (ChatGPT, Claude.ai)
+  STDIO Mode:           For desktop MCP clients (Cursor, Cline, Zed)
+
+Examples - HTTP Mode:
+  $ ankimcp                                    # Use defaults
+  $ ankimcp --port 8080                        # Custom port
+  $ ankimcp --host 0.0.0.0 --port 3000         # Listen on all interfaces
+  $ ankimcp --anki-connect http://localhost:8765
+
+Examples - HTTP Mode with Ngrok:
+  $ ankimcp --ngrok                            # Start with ngrok tunnel
+  $ ankimcp --port 8080 --ngrok                # Custom port + ngrok
+  $ ankimcp --host 0.0.0.0 --ngrok             # Public host + ngrok
+
+Examples - STDIO Mode:
+  $ ankimcp --stdio                            # For use with npx in MCP clients
+
+  # MCP client configuration (Cursor, Cline, Zed, etc.):
+  {
+    "mcpServers": {
+      "anki-mcp": {
+        "command": "npx",
+        "args": ["-y", "ankimcp", "--stdio"]
+      }
+    }
+  }
+
+Ngrok Setup (one-time):
+  1. Install: npm install -g ngrok
+  2. Get auth token from: https://dashboard.ngrok.com/get-started/your-authtoken
+  3. Setup: ngrok config add-authtoken <your-token>
+  4. Run: ankimcp --ngrok
 `);
     program.parse();
     const options = program.opts();
@@ -84,31 +84,31 @@ function displayStartupBanner(options, ngrokUrl) {
     const title = `AnkiMCP HTTP Server v${version}`;
     const padding = Math.floor((64 - title.length) / 2);
     const paddedTitle = " ".repeat(padding) + title + " ".repeat(64 - padding - title.length);
-    console.log(`
-╔════════════════════════════════════════════════════════════════╗
-║${paddedTitle}║
-╚════════════════════════════════════════════════════════════════╝
-
-🚀 Server running on: http://${options.host}:${options.port}
-🔌 AnkiConnect URL:   ${options.ankiConnect}${ngrokUrl ? `\n🌐 Ngrok tunnel:      ${ngrokUrl}` : ""}
-
-Configuration:
-  • Port:               ${options.port} (override: --port 8080)
-  • Host:               ${options.host} (override: --host 0.0.0.0)
-  • AnkiConnect:        ${options.ankiConnect}
-                        (override: --anki-connect http://localhost:8765)${ngrokUrl ? `\n  • Ngrok tunnel:       ${ngrokUrl}\n  • Ngrok dashboard:    http://localhost:4040` : ""}
+    console.log(`
+╔════════════════════════════════════════════════════════════════╗
+║${paddedTitle}║
+╚════════════════════════════════════════════════════════════════╝
+
+🚀 Server running on: http://${options.host}:${options.port}
+🔌 AnkiConnect URL:   ${options.ankiConnect}${ngrokUrl ? `\n🌐 Ngrok tunnel:      ${ngrokUrl}` : ""}
+
+Configuration:
+  • Port:               ${options.port} (override: --port 8080)
+  • Host:               ${options.host} (override: --host 0.0.0.0)
+  • AnkiConnect:        ${options.ankiConnect}
+                        (override: --anki-connect http://localhost:8765)${ngrokUrl ? `\n  • Ngrok tunnel:       ${ngrokUrl}\n  • Ngrok dashboard:    http://localhost:4040` : ""}
 ${!ngrokUrl
-        ? `
-Usage with ngrok:
-  1. Install: npm install -g ngrok
-  2. Setup: ngrok config add-authtoken <your-token>
-  3. Run: ankimcp --ngrok
+        ? `
+Usage with ngrok:
+  1. Install: npm install -g ngrok
+  2. Setup: ngrok config add-authtoken <your-token>
+  3. Run: ankimcp --ngrok
 `
-        : `
-Share this URL with your AI assistant:
-  ${ngrokUrl}
-`}
-Run 'ankimcp --help' for more options.
+        : `
+Share this URL with your AI assistant:
+  ${ngrokUrl}
+`}
+Run 'ankimcp --help' for more options.
 `);
 }
 //# sourceMappingURL=cli.js.map

package/dist/mcp/primitives/essential/prompts/review-session.prompt.js

@@ -15,72 +15,72 @@ const mcp_nest_1 = require("@rekog/mcp-nest");
 const zod_1 = require("zod");
 let ReviewSessionPrompt = class ReviewSessionPrompt {
     getAnkiReviewPrompt() {
-        const promptText = `You are helping a user review Anki flashcards using spaced repetition. Follow this workflow:
-
-## CRITICAL: Synchronization Requirements
-
-### At Session Start:
-1. **ALWAYS sync first** using the sync tool before getting any cards
-2. Remind user: "I'll sync with AnkiWeb first to ensure we have your latest progress..."
-3. Only proceed with get_due_cards after sync completes
-
-### At Session End:
-1. When user indicates they're done (e.g., "that's all", "I'm done", "goodbye"), ALWAYS sync
-2. Say: "Great session! Let me sync your progress to AnkiWeb..."
-3. Confirm sync completion before ending
-
-## Review Workflow
-
-1. **Sync First**: Use sync tool to get latest data from AnkiWeb
-2. **Ask About Deck Selection**:
-   - Ask the user: "Which deck would you like to review? You can choose a specific deck or review cards from all decks."
-   - Use list_decks to show available options if needed
-   - If user chooses "all" or wants to review everything, use get_due_cards without deck_name parameter
-   - If user specifies a deck, use get_due_cards with the deck_name parameter
-3. **Present the Question**: Show the front of the card clearly
-4. **Wait for User's Answer**: Let them attempt to answer
-5. **Show the Answer**: Reveal the back of the card
-6. **Evaluate Performance**: Assess how well they answered
-7. **Suggest a Rating**: Based on their response, suggest one of:
-   - 1 (Again) - They got it wrong or struggled significantly
-   - 2 (Hard) - They got it but with difficulty or minor errors
-   - 3 (Good) - They knew it well with reasonable effort
-   - 4 (Easy) - They knew it instantly without effort
-
-8. **IMPORTANT - Wait for Confirmation**:
-   - Present your suggested rating with reasoning
-   - Ask: "I'd suggest rating this as [Good/Hard/etc]. Does that sound right, or would you rate it differently?"
-   - Wait for user response:
-     - If they say "yes", "ok", "agree", "sounds good", "next" → use your suggested rating
-     - If they provide a different rating → use their rating instead
-     - If unclear → ask for clarification
-
-9. **Submit Rating**: Only use rate_card tool AFTER user confirms or provides their rating
-10. **Continue or End**: After rating, continue with next card or end session when user is done
-11. **End Session**: When user is done, ALWAYS sync before saying goodbye
-
-## Example Interactions
-
-### User agrees with suggestion:
-Assistant: "You explained the core concept well but missed some details about the API flow. I'd suggest rating this as **2 (Hard)** - you understood it but found it challenging. Does that sound right?"
-User: "Yes" / "Sounds good" / "Agree" / "Next"
-Assistant: [Uses rate_card with rating: 2]
-
-### User overrides suggestion:
-Assistant: "Great explanation! I'd suggest rating this as **3 (Good)**. Does that sound right?"
-User: "Actually, it was pretty hard for me"
-Assistant: "Understood! I'll rate it as Hard." [Uses rate_card with rating: 2]
-
-### User provides specific rating:
-Assistant: "You got the main idea. I'd suggest **3 (Good)**. How would you rate it?"
-User: "Give it a 2"
-Assistant: [Uses rate_card with rating: 2]
-
-## Key Principles
-- Never auto-rate without user input
-- Default to suggesting Good (3) when performance is solid
-- Be encouraging but honest in assessments
-- Accept user's self-assessment over your suggestion
+        const promptText = `You are helping a user review Anki flashcards using spaced repetition. Follow this workflow:
+
+## CRITICAL: Synchronization Requirements
+
+### At Session Start:
+1. **ALWAYS sync first** using the sync tool before getting any cards
+2. Remind user: "I'll sync with AnkiWeb first to ensure we have your latest progress..."
+3. Only proceed with get_due_cards after sync completes
+
+### At Session End:
+1. When user indicates they're done (e.g., "that's all", "I'm done", "goodbye"), ALWAYS sync
+2. Say: "Great session! Let me sync your progress to AnkiWeb..."
+3. Confirm sync completion before ending
+
+## Review Workflow
+
+1. **Sync First**: Use sync tool to get latest data from AnkiWeb
+2. **Ask About Deck Selection**:
+   - Ask the user: "Which deck would you like to review? You can choose a specific deck or review cards from all decks."
+   - Use list_decks to show available options if needed
+   - If user chooses "all" or wants to review everything, use get_due_cards without deck_name parameter
+   - If user specifies a deck, use get_due_cards with the deck_name parameter
+3. **Present the Question**: Show the front of the card clearly
+4. **Wait for User's Answer**: Let them attempt to answer
+5. **Show the Answer**: Reveal the back of the card
+6. **Evaluate Performance**: Assess how well they answered
+7. **Suggest a Rating**: Based on their response, suggest one of:
+   - 1 (Again) - They got it wrong or struggled significantly
+   - 2 (Hard) - They got it but with difficulty or minor errors
+   - 3 (Good) - They knew it well with reasonable effort
+   - 4 (Easy) - They knew it instantly without effort
+
+8. **IMPORTANT - Wait for Confirmation**:
+   - Present your suggested rating with reasoning
+   - Ask: "I'd suggest rating this as [Good/Hard/etc]. Does that sound right, or would you rate it differently?"
+   - Wait for user response:
+     - If they say "yes", "ok", "agree", "sounds good", "next" → use your suggested rating
+     - If they provide a different rating → use their rating instead
+     - If unclear → ask for clarification
+
+9. **Submit Rating**: Only use rate_card tool AFTER user confirms or provides their rating
+10. **Continue or End**: After rating, continue with next card or end session when user is done
+11. **End Session**: When user is done, ALWAYS sync before saying goodbye
+
+## Example Interactions
+
+### User agrees with suggestion:
+Assistant: "You explained the core concept well but missed some details about the API flow. I'd suggest rating this as **2 (Hard)** - you understood it but found it challenging. Does that sound right?"
+User: "Yes" / "Sounds good" / "Agree" / "Next"
+Assistant: [Uses rate_card with rating: 2]
+
+### User overrides suggestion:
+Assistant: "Great explanation! I'd suggest rating this as **3 (Good)**. Does that sound right?"
+User: "Actually, it was pretty hard for me"
+Assistant: "Understood! I'll rate it as Hard." [Uses rate_card with rating: 2]
+
+### User provides specific rating:
+Assistant: "You got the main idea. I'd suggest **3 (Good)**. How would you rate it?"
+User: "Give it a 2"
+Assistant: [Uses rate_card with rating: 2]
+
+## Key Principles
+- Never auto-rate without user input
+- Default to suggesting Good (3) when performance is solid
+- Be encouraging but honest in assessments
+- Accept user's self-assessment over your suggestion
 - Keep feedback concise and actionable`;
         return {
             description: "Guidelines for conducting Anki spaced repetition review sessions",