@ankimcp/anki-mcp-server 0.18.5 → 0.19.1

package/dist/app.module.js

@@ -13,17 +13,20 @@ const config_1 = require("@nestjs/config");
 const mcp_nest_1 = require("@rekog/mcp-nest");
 const essential_1 = require("./mcp/primitives/essential");
 const gui_1 = require("./mcp/primitives/gui");
-const anki_config_service_1 = require("./anki-config.service");
+const app_config_service_1 = require("./app-config.service");
+const config_2 = require("./config");
 const mcp_icons_1 = require("./mcp/mcp-icons");
+const tunnel_mcp_service_1 = require("./tunnel/tunnel-mcp.service");
 let AppModule = AppModule_1 = class AppModule {
-    static forStdio() {
+    static forStdio(configInput) {
+        const validatedConfig = config_2.configSchema.parse((0, config_2.transformEnvToConfig)(configInput));
         return {
             module: AppModule_1,
             imports: [
                 config_1.ConfigModule.forRoot({
                     isGlobal: true,
                     cache: true,
-                    envFilePath: [".env.local", ".env"],
+                    load: [() => validatedConfig],
                 }),
                 mcp_nest_1.McpModule.forRoot({
                     name: process.env.MCP_SERVER_NAME || "anki-mcp-server",
@@ -34,27 +37,45 @@ let AppModule = AppModule_1 = class AppModule {
                 essential_1.McpPrimitivesAnkiEssentialModule.forRoot({
                     ankiConfigProvider: {
                         provide: essential_1.ANKI_CONFIG,
-                        useClass: anki_config_service_1.AnkiConfigService,
+                        useClass: app_config_service_1.AppConfigService,
+                    },
+                    appConfigProvider: {
+                        provide: config_2.APP_CONFIG,
+                        useValue: validatedConfig,
                     },
                 }),
                 gui_1.McpPrimitivesAnkiGuiModule.forRoot({
                     ankiConfigProvider: {
                         provide: essential_1.ANKI_CONFIG,
-                        useClass: anki_config_service_1.AnkiConfigService,
+                        useClass: app_config_service_1.AppConfigService,
+                    },
+                    appConfigProvider: {
+                        provide: config_2.APP_CONFIG,
+                        useValue: validatedConfig,
                     },
                 }),
             ],
-            providers: [anki_config_service_1.AnkiConfigService, ...essential_1.ESSENTIAL_MCP_TOOLS, ...gui_1.GUI_MCP_TOOLS],
+            providers: [
+                {
+                    provide: config_2.APP_CONFIG,
+                    useValue: validatedConfig,
+                },
+                app_config_service_1.AppConfigService,
+                ...essential_1.ESSENTIAL_MCP_TOOLS,
+                ...gui_1.GUI_MCP_TOOLS,
+            ],
+            exports: [config_2.APP_CONFIG, app_config_service_1.AppConfigService],
         };
     }
-    static forHttp() {
+    static forHttp(configInput) {
+        const validatedConfig = config_2.configSchema.parse((0, config_2.transformEnvToConfig)(configInput));
         return {
             module: AppModule_1,
             imports: [
                 config_1.ConfigModule.forRoot({
                     isGlobal: true,
                     cache: true,
-                    envFilePath: [".env.local", ".env"],
+                    load: [() => validatedConfig],
                 }),
                 mcp_nest_1.McpModule.forRoot({
                     name: process.env.MCP_SERVER_NAME || "anki-mcp-server",
@@ -66,17 +87,84 @@ let AppModule = AppModule_1 = class AppModule {
                 essential_1.McpPrimitivesAnkiEssentialModule.forRoot({
                     ankiConfigProvider: {
                         provide: essential_1.ANKI_CONFIG,
-                        useClass: anki_config_service_1.AnkiConfigService,
+                        useClass: app_config_service_1.AppConfigService,
+                    },
+                    appConfigProvider: {
+                        provide: config_2.APP_CONFIG,
+                        useValue: validatedConfig,
+                    },
+                }),
+                gui_1.McpPrimitivesAnkiGuiModule.forRoot({
+                    ankiConfigProvider: {
+                        provide: essential_1.ANKI_CONFIG,
+                        useClass: app_config_service_1.AppConfigService,
+                    },
+                    appConfigProvider: {
+                        provide: config_2.APP_CONFIG,
+                        useValue: validatedConfig,
+                    },
+                }),
+            ],
+            providers: [
+                {
+                    provide: config_2.APP_CONFIG,
+                    useValue: validatedConfig,
+                },
+                app_config_service_1.AppConfigService,
+                ...essential_1.ESSENTIAL_MCP_TOOLS,
+                ...gui_1.GUI_MCP_TOOLS,
+            ],
+            exports: [config_2.APP_CONFIG, app_config_service_1.AppConfigService],
+        };
+    }
+    static forTunnel(cliOverrides) {
+        const validatedConfig = (0, config_2.loadValidatedConfig)(cliOverrides);
+        return {
+            module: AppModule_1,
+            imports: [
+                config_1.ConfigModule.forRoot({
+                    isGlobal: true,
+                    cache: true,
+                    load: [() => validatedConfig],
+                }),
+                mcp_nest_1.McpModule.forRoot({
+                    name: process.env.MCP_SERVER_NAME || "anki-mcp-server",
+                    version: process.env.MCP_SERVER_VERSION || "1.0.0",
+                    transport: [],
+                    icons: mcp_icons_1.MCP_ICONS,
+                }),
+                essential_1.McpPrimitivesAnkiEssentialModule.forRoot({
+                    ankiConfigProvider: {
+                        provide: essential_1.ANKI_CONFIG,
+                        useClass: app_config_service_1.AppConfigService,
+                    },
+                    appConfigProvider: {
+                        provide: config_2.APP_CONFIG,
+                        useValue: validatedConfig,
                     },
                 }),
                 gui_1.McpPrimitivesAnkiGuiModule.forRoot({
                     ankiConfigProvider: {
                         provide: essential_1.ANKI_CONFIG,
-                        useClass: anki_config_service_1.AnkiConfigService,
+                        useClass: app_config_service_1.AppConfigService,
+                    },
+                    appConfigProvider: {
+                        provide: config_2.APP_CONFIG,
+                        useValue: validatedConfig,
                     },
                 }),
             ],
-            providers: [anki_config_service_1.AnkiConfigService, ...essential_1.ESSENTIAL_MCP_TOOLS, ...gui_1.GUI_MCP_TOOLS],
+            providers: [
+                {
+                    provide: config_2.APP_CONFIG,
+                    useValue: validatedConfig,
+                },
+                app_config_service_1.AppConfigService,
+                tunnel_mcp_service_1.TunnelMcpService,
+                ...essential_1.ESSENTIAL_MCP_TOOLS,
+                ...gui_1.GUI_MCP_TOOLS,
+            ],
+            exports: [config_2.APP_CONFIG, app_config_service_1.AppConfigService, tunnel_mcp_service_1.TunnelMcpService],
         };
     }
 };

package/dist/app.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,2CAA8C;AAC9C,8CAA8D;AAC9D,0DAIoC;AACpC,8CAG8B;AAC9B,+DAA0D;AAC1D,+CAA4C;AAGrC,IAAM,SAAS,iBAAf,MAAM,SAAS;IAIpB,MAAM,CAAC,QAAQ;QACb,OAAO;YACL,MAAM,EAAE,WAAS;YACjB,OAAO,EAAE;gBAEP,qBAAY,CAAC,OAAO,CAAC;oBACnB,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,IAAI;oBACX,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC;iBACpC,CAAC;gBAGF,oBAAS,CAAC,OAAO,CAAC;oBAChB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,iBAAiB;oBACtD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO;oBAClD,SAAS,EAAE,2BAAgB,CAAC,KAAK;oBACjC,KAAK,EAAE,qBAAS;iBACjB,CAAC;gBAGF,4CAAgC,CAAC,OAAO,CAAC;oBACvC,kBAAkB,EAAE;wBAClB,OAAO,EAAE,uBAAW;wBACpB,QAAQ,EAAE,uCAAiB;qBAC5B;iBACF,CAAC;gBAGF,gCAA0B,CAAC,OAAO,CAAC;oBACjC,kBAAkB,EAAE;wBAClB,OAAO,EAAE,uBAAW;wBACpB,QAAQ,EAAE,uCAAiB;qBAC5B;iBACF,CAAC;aACH;YAED,SAAS,EAAE,CAAC,uCAAiB,EAAE,GAAG,+BAAmB,EAAE,GAAG,mBAAa,CAAC;SACzE,CAAC;IACJ,CAAC;IAKD,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,MAAM,EAAE,WAAS;YACjB,OAAO,EAAE;gBAEP,qBAAY,CAAC,OAAO,CAAC;oBACnB,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,IAAI;oBACX,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC;iBACpC,CAAC;gBAGF,oBAAS,CAAC,OAAO,CAAC;oBAChB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,iBAAiB;oBACtD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO;oBAClD,SAAS,EAAE,2BAAgB,CAAC,eAAe;oBAC3C,WAAW,EAAE,GAAG;oBAChB,KAAK,EAAE,qBAAS;iBACjB,CAAC;gBAGF,4CAAgC,CAAC,OAAO,CAAC;oBACvC,kBAAkB,EAAE;wBAClB,OAAO,EAAE,uBAAW;wBACpB,QAAQ,EAAE,uCAAiB;qBAC5B;iBACF,CAAC;gBAGF,gCAA0B,CAAC,OAAO,CAAC;oBACjC,kBAAkB,EAAE;wBAClB,OAAO,EAAE,uBAAW;wBACpB,QAAQ,EAAE,uCAAiB;qBAC5B;iBACF,CAAC;aACH;YAED,SAAS,EAAE,CAAC,uCAAiB,EAAE,GAAG,+BAAmB,EAAE,GAAG,mBAAa,CAAC;SACzE,CAAC;IACJ,CAAC;CACF,CAAA;AAvFY,8BAAS;oBAAT,SAAS;IADrB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,SAAS,CAuFrB"}
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":"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"}

package/dist/bootstrap.d.ts

@@ -1,3 +1,8 @@
 import { LoggerService } from "@nestjs/common";
-export declare function createPinoLogger(destination: 1 | 2): import("pino").Logger<never, boolean>;
+export declare const LOG_DESTINATION: {
+    readonly STDOUT: 1;
+    readonly STDERR: 2;
+};
+export type LogDestination = (typeof LOG_DESTINATION)[keyof typeof LOG_DESTINATION];
+export declare function createPinoLogger(destination: LogDestination, logLevel?: string): import("pino").Logger<never, boolean>;
 export declare function createLoggerService(pinoLogger: any): LoggerService;

package/dist/bootstrap.js

@@ -1,11 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOG_DESTINATION = void 0;
 exports.createPinoLogger = createPinoLogger;
 exports.createLoggerService = createLoggerService;
 const pino_1 = require("pino");
-function createPinoLogger(destination) {
+exports.LOG_DESTINATION = {
+    STDOUT: 1,
+    STDERR: 2,
+};
+function createPinoLogger(destination, logLevel = "info") {
     return (0, pino_1.pino)({
-        level: process.env.LOG_LEVEL || "info",
+        level: logLevel,
         transport: {
             target: "pino-pretty",
             options: {

package/dist/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":";;AASA,4CAaC;AAQD,kDAkBC;AA/CD,+BAA4B;AAQ5B,SAAgB,gBAAgB,CAAC,WAAkB;IACjD,OAAO,IAAA,WAAI,EAAC;QACV,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;QACtC,SAAS,EAAE;YACT,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,WAAW;gBACX,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,YAAY;gBAC3B,MAAM,EAAE,cAAc;aACvB;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAQD,SAAgB,mBAAmB,CAAC,UAAe;IACjD,OAAO;QACL,GAAG,EAAE,CAAC,OAAY,EAAE,OAAgB,EAAE,EAAE;YACtC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,EAAE,CAAC,OAAY,EAAE,KAAc,EAAE,OAAgB,EAAE,EAAE;YACxD,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,EAAE,CAAC,OAAY,EAAE,OAAgB,EAAE,EAAE;YACvC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,EAAE,CAAC,OAAY,EAAE,OAAgB,EAAE,EAAE;YACxC,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,EAAE,CAAC,OAAY,EAAE,OAAgB,EAAE,EAAE;YAC1C,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":";;;AAuBA,4CAgBC;AAQD,kDAkBC;AAhED,+BAA4B;AAKf,QAAA,eAAe,GAAG;IAE7B,MAAM,EAAE,CAAC;IAET,MAAM,EAAE,CAAC;CACD,CAAC;AAYX,SAAgB,gBAAgB,CAC9B,WAA2B,EAC3B,WAAmB,MAAM;IAEzB,OAAO,IAAA,WAAI,EAAC;QACV,KAAK,EAAE,QAAQ;QACf,SAAS,EAAE;YACT,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,WAAW;gBACX,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,YAAY;gBAC3B,MAAM,EAAE,cAAc;aACvB;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAQD,SAAgB,mBAAmB,CAAC,UAAe;IACjD,OAAO;QACL,GAAG,EAAE,CAAC,OAAY,EAAE,OAAgB,EAAE,EAAE;YACtC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,EAAE,CAAC,OAAY,EAAE,KAAc,EAAE,OAAgB,EAAE,EAAE;YACxD,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,EAAE,CAAC,OAAY,EAAE,OAAgB,EAAE,EAAE;YACvC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,EAAE,CAAC,OAAY,EAAE,OAAgB,EAAE,EAAE;YACxC,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,EAAE,CAAC,OAAY,EAAE,OAAgB,EAAE,EAAE;YAC1C,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/__tests__/cli-output.manual.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/__tests__/cli-output.manual.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_output_1 = require("../cli-output");
+const cli = (0, cli_output_1.createCli)(false);
+cli.success("Successfully connected to Anki");
+cli.error("Failed to connect to AnkiConnect");
+cli.warn("AnkiConnect is not running");
+cli.info("Server listening on http://localhost:3000");
+cli.blank();
+cli.dim("(Use Ctrl+C to stop)");
+cli.blank();
+cli.box("Ngrok Tunnel Active", "https://abc123.ngrok.io");
+//# sourceMappingURL=cli-output.manual.js.map

package/dist/cli/__tests__/cli-output.manual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.manual.js","sourceRoot":"","sources":["../../../src/cli/__tests__/cli-output.manual.ts"],"names":[],"mappings":";;;AAOA,8CAA0C;AAE1C,MAAM,GAAG,GAAG,IAAA,sBAAS,EAAC,KAAK,CAAC,CAAC;AAG7B,GAAG,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;AAC9C,GAAG,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;AAC9C,GAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;AACvC,GAAG,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;AACtD,GAAG,CAAC,KAAK,EAAE,CAAC;AACZ,GAAG,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAChC,GAAG,CAAC,KAAK,EAAE,CAAC;AACZ,GAAG,CAAC,GAAG,CAAC,qBAAqB,EAAE,yBAAyB,CAAC,CAAC"}

package/dist/cli/args.d.ts

@@ -0,0 +1,16 @@
+import { type Cli } from "./cli-output";
+export interface CliOptions {
+    port: number;
+    host: string;
+    ankiConnect: string;
+    ngrok: boolean;
+    readOnly: boolean;
+    login: string | boolean;
+    logout: boolean;
+    tunnel: string | boolean;
+    debug: boolean;
+}
+export declare function checkForUpdates(): void;
+export declare function parseOptionalUrl(raw: string | boolean, flag: string, cli: Cli): string | undefined;
+export declare function parseCliArgs(): CliOptions;
+export declare function displayStartupBanner(cli: Cli, options: CliOptions, ngrokUrl?: string): void;

package/dist/{cli.js → cli/args.js}

@@ -4,38 +4,60 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkForUpdates = checkForUpdates;
+exports.parseOptionalUrl = parseOptionalUrl;
 exports.parseCliArgs = parseCliArgs;
 exports.displayStartupBanner = displayStartupBanner;
 const commander_1 = require("commander");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const update_notifier_1 = __importDefault(require("update-notifier"));
+const cli_output_1 = require("./cli-output");
+const version_1 = require("../version");
 function getPackageJson() {
     try {
-        return JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, "../package.json"), "utf-8"));
+        return JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, "../../package.json"), "utf-8"));
     }
     catch {
         return { version: "0.0.0", name: "ankimcp" };
     }
 }
-function getVersion() {
-    return getPackageJson().version;
-}
 function checkForUpdates() {
     (0, update_notifier_1.default)({ pkg: getPackageJson() }).notify();
 }
+function parseOptionalUrl(raw, flag, cli) {
+    if (raw === false || raw === true) {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        cli.error(`Invalid ${flag} URL: ${raw === "" ? "(empty string)" : raw}. Expected a ws:// or wss:// URL.`);
+        process.exit(1);
+    }
+    if (parsed.protocol !== "ws:" && parsed.protocol !== "wss:") {
+        cli.error(`Invalid ${flag} URL protocol: ${parsed.protocol}. Expected ws:// or wss://.`);
+        process.exit(1);
+    }
+    return raw;
+}
 function parseCliArgs() {
     const program = new commander_1.Command();
     program
         .name("ankimcp")
         .description("AnkiMCP Server - Model Context Protocol server for Anki")
-        .version(getVersion())
+        .version((0, version_1.getVersion)())
         .option("--stdio", "Run in STDIO mode (for MCP clients like Cursor, Cline, Zed)")
         .option("-p, --port <number>", "Port to listen on (HTTP mode)", "3000")
         .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)")
         .option("--read-only", "Run in read-only mode (blocks all write operations)")
+        .option("--login [url]", "Authenticate with tunnel service (also triggered automatically by --tunnel when needed)")
+        .option("--logout", "Clear tunnel credentials")
+        .option("--tunnel [url]", "Connect to tunnel server (auto-launches browser login if not authenticated; default URL: wss://tunnel.ankimcp.ai)")
+        .option("-d, --debug", "Enable debug logging (shows stack traces)")
         .addHelpText("after", `
 Transport Modes:
   HTTP Mode (default):  For web-based AI assistants (ChatGPT, Claude.ai)
@@ -74,6 +96,14 @@ Ngrok Setup (one-time):
   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
+
+Tunnel Mode:
+  $ ankimcp --tunnel                          # Connect to wss://tunnel.ankimcp.ai
+                                              # (auto-launches browser login if needed)
+  $ ankimcp --tunnel wss://tunnel.ankimcp.ai/tunnel  # Production tunnel (explicit)
+  $ ankimcp --login                           # Pre-authenticate (optional)
+  $ ankimcp --login wss://custom.server.com/tunnel   # Login to custom server
+  $ ankimcp --logout                          # Clear saved credentials
 `);
     program.parse();
     const options = program.opts();
@@ -83,20 +113,18 @@ Ngrok Setup (one-time):
         ankiConnect: options.ankiConnect,
         ngrok: options.ngrok || false,
         readOnly: options.readOnly || false,
+        login: options.login ?? false,
+        logout: options.logout || false,
+        tunnel: options.tunnel ?? false,
+        debug: options.debug || false,
     };
 }
-function displayStartupBanner(options, ngrokUrl) {
-    const version = getVersion();
-    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);
+function displayStartupBanner(cli, options, ngrokUrl) {
     const readOnlyWarning = options.readOnly
         ? "\n\n** READ-ONLY MODE ENABLED **\nContent modifications (addNote, deleteNotes, createDeck, etc.) are blocked.\nReview operations (sync, answerCards, suspend) remain available."
         : "";
-    console.log(`
-╔════════════════════════════════════════════════════════════════╗
-║${paddedTitle}║
-╚════════════════════════════════════════════════════════════════╝${readOnlyWarning}
+    cli.info(`
+${(0, cli_output_1.formatBanner)("HTTP")}${readOnlyWarning}
 
 🚀 Server running on: http://${options.host}:${options.port}
 🔌 AnkiConnect URL:   ${options.ankiConnect}${ngrokUrl ? `\n🌐 Ngrok tunnel:      ${ngrokUrl}` : ""}${options.readOnly ? "\n🔒 Mode:              Read-only" : ""}
@@ -108,10 +136,9 @@ Configuration:
                         (override: --anki-connect http://localhost:8765)${options.readOnly ? "\n  • Read-only:          Yes (write operations blocked)" : ""}${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
+Want remote access?
+  • Tunnel (recommended): ankimcp --tunnel
+  • ngrok also supported — run 'ankimcp --help' or see the docs
 `
         : `
 Share this URL with your AI assistant:
@@ -120,4 +147,4 @@ Share this URL with your AI assistant:
 Run 'ankimcp --help' for more options.
 `);
 }
-//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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"}

package/dist/cli/cli-output.d.ts

@@ -0,0 +1,18 @@
+export declare function success(message: string): void;
+export declare function warn(message: string): void;
+export declare function info(message: string): void;
+export declare function blank(): void;
+export declare function box(title: string, content: string): void;
+export declare function formatBanner(label: string): string;
+export declare function dim(message: string): void;
+export declare function error(message: string, err?: Error, debug?: boolean): void;
+export interface Cli {
+    success(message: string): void;
+    error(message: string, err?: Error): void;
+    warn(message: string): void;
+    info(message: string): void;
+    blank(): void;
+    box(title: string, content: string): void;
+    dim(message: string): void;
+}
+export declare function createCli(debug: boolean): Cli;

package/dist/cli/cli-output.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.success = success;
+exports.warn = warn;
+exports.info = info;
+exports.blank = blank;
+exports.box = box;
+exports.formatBanner = formatBanner;
+exports.dim = dim;
+exports.error = error;
+exports.createCli = createCli;
+const version_1 = require("../version");
+const colors = {
+    reset: "\x1b[0m",
+    green: "\x1b[32m",
+    red: "\x1b[31m",
+    yellow: "\x1b[33m",
+    cyan: "\x1b[36m",
+    dim: "\x1b[2m",
+};
+function success(message) {
+    console.log(`${colors.green}✓${colors.reset} ${message}`);
+}
+function warn(message) {
+    console.warn(`${colors.yellow}!${colors.reset} ${message}`);
+}
+function info(message) {
+    console.log(message);
+}
+function blank() {
+    console.log();
+}
+function box(title, content) {
+    const width = Math.max(title.length, content.length) + 4;
+    const border = "─".repeat(width);
+    console.log(`┌${border}┐`);
+    console.log(`│ ${title.padEnd(width - 2)} │`);
+    console.log(`├${border}┤`);
+    console.log(`│ ${content.padEnd(width - 2)} │`);
+    console.log(`└${border}┘`);
+}
+function formatBanner(label) {
+    const version = (0, version_1.getVersion)();
+    const title = `AnkiMCP ${label} Server v${version}`;
+    const innerWidth = 64;
+    const padding = Math.floor((innerWidth - title.length) / 2);
+    const paddedTitle = " ".repeat(padding) +
+        title +
+        " ".repeat(innerWidth - padding - title.length);
+    return `╔════════════════════════════════════════════════════════════════╗
+║${paddedTitle}║
+╚════════════════════════════════════════════════════════════════╝`;
+}
+function dim(message) {
+    console.log(`${colors.dim}${message}${colors.reset}`);
+}
+function error(message, err, debug = false) {
+    console.error(`${colors.red}✗${colors.reset} ${message}`);
+    if (err && debug && err.stack) {
+        console.error(`${colors.dim}${err.stack}${colors.reset}`);
+    }
+}
+function createCli(debug) {
+    return {
+        success,
+        warn,
+        info,
+        blank,
+        box,
+        dim,
+        error: (message, err) => error(message, err, debug),
+    };
+}
+//# sourceMappingURL=cli-output.js.map

package/dist/cli/cli-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.js","sourceRoot":"","sources":["../../src/cli/cli-output.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./args";
+export * from "./cli-output";
+export * from "./spinner";

package/dist/cli/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./args"), exports);
+__exportStar(require("./cli-output"), exports);
+__exportStar(require("./spinner"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,+CAA6B;AAC7B,4CAA0B"}

package/dist/cli/spinner.d.ts

@@ -0,0 +1 @@
+export declare function startSpinner(message: string): () => void;

package/dist/cli/spinner.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startSpinner = startSpinner;
+function startSpinner(message) {
+    const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+    let i = 0;
+    const interval = setInterval(() => {
+        process.stdout.write(`\r${frames[i]} ${message}`);
+        i = (i + 1) % frames.length;
+    }, 80);
+    return () => {
+        clearInterval(interval);
+        process.stdout.write("\r");
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/cli/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/cli/spinner.ts"],"names":[],"mappings":";;AAmBA,oCAaC;AAbD,SAAgB,YAAY,CAAC,OAAe;IAC1C,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClE,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;QAClD,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,GAAG,EAAE;QACV,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC"}

package/dist/config/config.factory.d.ts

@@ -0,0 +1,13 @@
+import { AppConfig } from "./config.schema";
+export type ConfigInput = Record<string, string | undefined>;
+export interface CliOverrides {
+    port?: number;
+    host?: string;
+    ankiConnect?: string;
+    readOnly?: boolean;
+    tunnel?: string | boolean;
+    ngrok?: boolean;
+    debug?: boolean;
+}
+export declare function buildConfigInput(cliOverrides?: CliOverrides): ConfigInput;
+export declare function loadValidatedConfig(cliOverrides?: CliOverrides): AppConfig;

package/dist/config/config.factory.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildConfigInput = buildConfigInput;
+exports.loadValidatedConfig = loadValidatedConfig;
+const config_schema_1 = require("./config.schema");
+function buildConfigInput(cliOverrides = {}) {
+    const input = { ...process.env };
+    if (cliOverrides.port !== undefined) {
+        input.PORT = String(cliOverrides.port);
+    }
+    if (cliOverrides.host !== undefined) {
+        input.HOST = cliOverrides.host;
+    }
+    if (cliOverrides.ankiConnect !== undefined) {
+        input.ANKI_CONNECT_URL = cliOverrides.ankiConnect;
+    }
+    if (cliOverrides.readOnly !== undefined) {
+        input.READ_ONLY = cliOverrides.readOnly ? "true" : "false";
+    }
+    if (typeof cliOverrides.tunnel === "string") {
+        input.TUNNEL_SERVER_URL = cliOverrides.tunnel;
+    }
+    if (cliOverrides.debug) {
+        input.LOG_LEVEL = "debug";
+    }
+    return input;
+}
+function loadValidatedConfig(cliOverrides = {}) {
+    const input = buildConfigInput(cliOverrides);
+    return config_schema_1.configSchema.parse((0, config_schema_1.transformEnvToConfig)(input));
+}
+//# sourceMappingURL=config.factory.js.map

package/dist/config/config.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.factory.js","sourceRoot":"","sources":["../../src/config/config.factory.ts"],"names":[],"mappings":";;AA8BA,4CAwBC;AAMD,kDAKC;AAjED,mDAAgF;AA8BhF,SAAgB,gBAAgB,CAAC,eAA6B,EAAE;IAE9D,MAAM,KAAK,GAAgB,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE9C,IAAI,YAAY,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;IACjC,CAAC;IACD,IAAI,YAAY,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAC3C,KAAK,CAAC,gBAAgB,GAAG,YAAY,CAAC,WAAW,CAAC;IACpD,CAAC;IACD,IAAI,YAAY,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACxC,KAAK,CAAC,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,YAAY,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC5C,KAAK,CAAC,iBAAiB,GAAG,YAAY,CAAC,MAAM,CAAC;IAChD,CAAC;IACD,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;QACvB,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAMD,SAAgB,mBAAmB,CACjC,eAA6B,EAAE;IAE/B,MAAM,KAAK,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC7C,OAAO,4BAAY,CAAC,KAAK,CAAC,IAAA,oCAAoB,EAAC,KAAK,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/config/config.schema.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export declare const configSchema: z.ZodObject<{
+    port: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    host: z.ZodDefault<z.ZodString>;
+    nodeEnv: z.ZodDefault<z.ZodEnum<{
+        development: "development";
+        production: "production";
+        test: "test";
+    }>>;
+    ankiConnect: z.ZodObject<{
+        url: z.ZodDefault<z.ZodString>;
+        apiKey: z.ZodOptional<z.ZodString>;
+        apiVersion: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        timeout: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>;
+    auth: z.ZodObject<{
+        clientId: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    tunnel: z.ZodObject<{
+        serverUrl: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    readOnly: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    logLevel: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+    }>>;
+}, z.core.$strip>;
+export type AppConfig = z.infer<typeof configSchema>;
+export declare function transformEnvToConfig(env: Record<string, any>): any;