@ankimcp/anki-mcp-server 0.8.0

package/bin/ankimcp.js

@@ -0,0 +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');
+}

package/dist/anki-config.service.d.ts

@@ -0,0 +1,10 @@
+import { ConfigService } from "@nestjs/config";
+import { IAnkiConfig } from "./mcp/config/anki-config.interface";
+export declare class AnkiConfigService implements IAnkiConfig {
+    private configService;
+    constructor(configService: ConfigService);
+    get ankiConnectUrl(): string;
+    get ankiConnectApiVersion(): number;
+    get ankiConnectApiKey(): string | undefined;
+    get ankiConnectTimeout(): number;
+}

package/dist/anki-config.service.js

@@ -0,0 +1,42 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnkiConfigService = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const mcpb_workarounds_1 = require("./mcp/utils/mcpb-workarounds");
+let AnkiConfigService = class AnkiConfigService {
+    configService;
+    constructor(configService) {
+        this.configService = configService;
+    }
+    get ankiConnectUrl() {
+        return this.configService.get("ANKI_CONNECT_URL", "http://localhost:8765");
+    }
+    get ankiConnectApiVersion() {
+        const version = this.configService.get("ANKI_CONNECT_API_VERSION", "6");
+        return parseInt(version, 10);
+    }
+    get ankiConnectApiKey() {
+        const apiKey = this.configService.get("ANKI_CONNECT_API_KEY");
+        return (0, mcpb_workarounds_1.sanitizeMcpbConfigValue)(apiKey);
+    }
+    get ankiConnectTimeout() {
+        const timeout = this.configService.get("ANKI_CONNECT_TIMEOUT", "5000");
+        return parseInt(timeout, 10);
+    }
+};
+exports.AnkiConfigService = AnkiConfigService;
+exports.AnkiConfigService = AnkiConfigService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_1.ConfigService])
+], AnkiConfigService);
+//# sourceMappingURL=anki-config.service.js.map

package/dist/anki-config.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anki-config.service.js","sourceRoot":"","sources":["../src/anki-config.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAA+C;AAE/C,mEAAuE;AAMhE,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IACR;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAC3B,kBAAkB,EAClB,uBAAuB,CACxB,CAAC;IACJ,CAAC;IAED,IAAI,qBAAqB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CACpC,0BAA0B,EAC1B,GAAG,CACJ,CAAC;QACF,OAAO,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,iBAAiB;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAS,sBAAsB,CAAC,CAAC;QACtE,OAAO,IAAA,0CAAuB,EAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,kBAAkB;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CACpC,sBAAsB,EACtB,MAAM,CACP,CAAC;QACF,OAAO,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;CACF,CAAA;AA9BY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAEwB,sBAAa;GADrC,iBAAiB,CA8B7B"}

package/dist/app.module.d.ts

@@ -0,0 +1,5 @@
+import { DynamicModule } from "@nestjs/common";
+export declare class AppModule {
+    static forStdio(): DynamicModule;
+    static forHttp(): DynamicModule;
+}

package/dist/app.module.js

@@ -0,0 +1,84 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var AppModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModule = void 0;
+const common_1 = require("@nestjs/common");
+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");
+let AppModule = AppModule_1 = class AppModule {
+    static forStdio() {
+        return {
+            module: AppModule_1,
+            imports: [
+                config_1.ConfigModule.forRoot({
+                    isGlobal: true,
+                    cache: true,
+                    envFilePath: [".env.local", ".env"],
+                }),
+                mcp_nest_1.McpModule.forRoot({
+                    name: process.env.MCP_SERVER_NAME || "anki-mcp-server",
+                    version: process.env.MCP_SERVER_VERSION || "1.0.0",
+                    transport: mcp_nest_1.McpTransportType.STDIO,
+                }),
+                essential_1.McpPrimitivesAnkiEssentialModule.forRoot({
+                    ankiConfigProvider: {
+                        provide: essential_1.ANKI_CONFIG,
+                        useClass: anki_config_service_1.AnkiConfigService,
+                    },
+                }),
+                gui_1.McpPrimitivesAnkiGuiModule.forRoot({
+                    ankiConfigProvider: {
+                        provide: essential_1.ANKI_CONFIG,
+                        useClass: anki_config_service_1.AnkiConfigService,
+                    },
+                }),
+            ],
+            providers: [anki_config_service_1.AnkiConfigService],
+        };
+    }
+    static forHttp() {
+        return {
+            module: AppModule_1,
+            imports: [
+                config_1.ConfigModule.forRoot({
+                    isGlobal: true,
+                    cache: true,
+                    envFilePath: [".env.local", ".env"],
+                }),
+                mcp_nest_1.McpModule.forRoot({
+                    name: process.env.MCP_SERVER_NAME || "anki-mcp-server",
+                    version: process.env.MCP_SERVER_VERSION || "1.0.0",
+                    transport: mcp_nest_1.McpTransportType.STREAMABLE_HTTP,
+                    mcpEndpoint: "/",
+                }),
+                essential_1.McpPrimitivesAnkiEssentialModule.forRoot({
+                    ankiConfigProvider: {
+                        provide: essential_1.ANKI_CONFIG,
+                        useClass: anki_config_service_1.AnkiConfigService,
+                    },
+                }),
+                gui_1.McpPrimitivesAnkiGuiModule.forRoot({
+                    ankiConfigProvider: {
+                        provide: essential_1.ANKI_CONFIG,
+                        useClass: anki_config_service_1.AnkiConfigService,
+                    },
+                }),
+            ],
+            providers: [anki_config_service_1.AnkiConfigService],
+        };
+    }
+};
+exports.AppModule = AppModule;
+exports.AppModule = AppModule = AppModule_1 = __decorate([
+    (0, common_1.Module)({})
+], AppModule);
+//# sourceMappingURL=app.module.js.map

package/dist/app.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.module.js","sourceRoot":"","sources":["../src/app.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,2CAA8C;AAC9C,8CAA8D;AAC9D,0DAGoC;AACpC,8CAAkE;AAClE,+DAA0D;AAGnD,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;iBAClC,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;YACD,SAAS,EAAE,CAAC,uCAAiB,CAAC;SAC/B,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;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;YACD,SAAS,EAAE,CAAC,uCAAiB,CAAC;SAC/B,CAAC;IACJ,CAAC;CACF,CAAA;AAnFY,8BAAS;oBAAT,SAAS;IADrB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,SAAS,CAmFrB"}

package/dist/bootstrap.d.ts

@@ -0,0 +1,3 @@
+import { LoggerService } from "@nestjs/common";
+export declare function createPinoLogger(destination: 1 | 2): import("pino").Logger<never, boolean>;
+export declare function createLoggerService(pinoLogger: any): LoggerService;

package/dist/bootstrap.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPinoLogger = createPinoLogger;
+exports.createLoggerService = createLoggerService;
+const pino_1 = require("pino");
+function createPinoLogger(destination) {
+    return (0, pino_1.pino)({
+        level: process.env.LOG_LEVEL || "info",
+        transport: {
+            target: "pino-pretty",
+            options: {
+                destination,
+                colorize: true,
+                translateTime: "HH:MM:ss Z",
+                ignore: "pid,hostname",
+            },
+        },
+    });
+}
+function createLoggerService(pinoLogger) {
+    return {
+        log: (message, context) => {
+            pinoLogger.info({ context }, message);
+        },
+        error: (message, trace, context) => {
+            pinoLogger.error({ context, trace }, message);
+        },
+        warn: (message, context) => {
+            pinoLogger.warn({ context }, message);
+        },
+        debug: (message, context) => {
+            pinoLogger.debug({ context }, message);
+        },
+        verbose: (message, context) => {
+            pinoLogger.trace({ context }, message);
+        },
+    };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

@@ -0,0 +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"}

package/dist/cli.d.ts

@@ -0,0 +1,9 @@
+export interface CliOptions {
+    port: number;
+    host: string;
+    ankiConnect: string;
+    ngrok: boolean;
+}
+export declare function checkForUpdates(): void;
+export declare function parseCliArgs(): CliOptions;
+export declare function displayStartupBanner(options: CliOptions, ngrokUrl?: string): void;

package/dist/cli.js

@@ -0,0 +1,114 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkForUpdates = checkForUpdates;
+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"));
+function getPackageJson() {
+    try {
+        return JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, "../package.json"), "utf-8"));
+    }
+    catch {
+        return { version: "0.0.0", name: "anki-mcp-http" };
+    }
+}
+function getVersion() {
+    return getPackageJson().version;
+}
+function checkForUpdates() {
+    (0, update_notifier_1.default)({ pkg: getPackageJson() }).notify();
+}
+function parseCliArgs() {
+    const program = new commander_1.Command();
+    program
+        .name("ankimcp")
+        .description("AnkiMCP Server - Model Context Protocol server for Anki")
+        .version(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)")
+        .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:
+  $ anki-mcp-http                                    # Use defaults
+  $ anki-mcp-http --port 8080                        # Custom port
+  $ anki-mcp-http --host 0.0.0.0 --port 3000         # Listen on all interfaces
+  $ anki-mcp-http --anki-connect http://localhost:8765
+
+Examples - HTTP Mode with Ngrok:
+  $ anki-mcp-http --ngrok                            # Start with ngrok tunnel
+  $ anki-mcp-http --port 8080 --ngrok                # Custom port + ngrok
+  $ anki-mcp-http --host 0.0.0.0 --ngrok             # Public host + ngrok
+
+Examples - STDIO Mode:
+  $ anki-mcp-http --stdio                            # For use with npx in MCP clients
+
+  # MCP client configuration (Cursor, Cline, Zed, etc.):
+  {
+    "mcpServers": {
+      "anki-mcp": {
+        "command": "npx",
+        "args": ["-y", "anki-mcp-http", "--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: anki-mcp-http --ngrok
+`);
+    program.parse();
+    const options = program.opts();
+    return {
+        port: parseInt(options.port.toString(), 10),
+        host: options.host,
+        ankiConnect: options.ankiConnect,
+        ngrok: options.ngrok || 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);
+    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: anki-mcp-http --ngrok
+`
+        : `
+Share this URL with your AI assistant:
+  ${ngrokUrl}
+`}
+Run 'anki-mcp-http --help' for more options.
+`);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;AA0BA,0CAEC;AAED,oCAuEC;AAED,oDAsCC;AA7ID,yCAAoC;AACpC,2BAAkC;AAClC,+BAA4B;AAC5B,sEAA6C;AAS7C,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CACf,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAC1D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IACrD,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,cAAc,EAAE,CAAC,OAAO,CAAC;AAClC,CAAC;AAED,SAAgB,eAAe;IAC7B,IAAA,yBAAc,EAAC,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACrD,CAAC;AAED,SAAgB,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,SAAS,CAAC;SACf,WAAW,CAAC,yDAAyD,CAAC;SACtE,OAAO,CAAC,UAAU,EAAE,CAAC;SACrB,MAAM,CACL,SAAS,EACT,6DAA6D,CAC9D;SACA,MAAM,CAAC,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,CAAC;SACtE,MAAM,CAAC,sBAAsB,EAAE,6BAA6B,EAAE,WAAW,CAAC;SAC1E,MAAM,CACL,0BAA0B,EAC1B,iBAAiB,EACjB,uBAAuB,CACxB;SACA,MAAM,CACL,SAAS,EACT,yDAAyD,CAC1D;SACA,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCL,CACI,CAAC;IAEJ,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAc,CAAC;IAE3C,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC3C,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;KAC9B,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAClC,OAAmB,EACnB,QAAiB;IAEjB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,wBAAwB,OAAO,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,MAAM,WAAW,GACf,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAExE,OAAO,CAAC,GAAG,CAAC;;GAEX,WAAW;;;+BAGiB,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI;wBACnC,OAAO,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;;;0BAGzE,OAAO,CAAC,IAAI;0BACZ,OAAO,CAAC,IAAI;0BACZ,OAAO,CAAC,WAAW;0EAC6B,QAAQ,CAAC,CAAC,CAAC,6BAA6B,QAAQ,iDAAiD,CAAC,CAAC,CAAC,EAAE;EAE9K,CAAC,QAAQ;QACP,CAAC,CAAC;;;;;CAKL;QACG,CAAC,CAAC;;IAEF,QAAQ;CAEZ;;CAEC,CAAC,CAAC;AACH,CAAC"}

package/dist/http/guards/origin-validation.guard.d.ts

@@ -0,0 +1,7 @@
+import { CanActivate, ExecutionContext } from "@nestjs/common";
+export declare class OriginValidationGuard implements CanActivate {
+    private readonly allowedOrigins;
+    constructor();
+    canActivate(context: ExecutionContext): boolean;
+    private matchesPattern;
+}

package/dist/http/guards/origin-validation.guard.js

@@ -0,0 +1,52 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OriginValidationGuard = void 0;
+const common_1 = require("@nestjs/common");
+let OriginValidationGuard = class OriginValidationGuard {
+    allowedOrigins;
+    constructor() {
+        const defaultOrigins = "http://localhost:*,http://127.0.0.1:*,https://localhost:*,https://127.0.0.1:*";
+        const originsEnv = process.env.ALLOWED_ORIGINS || defaultOrigins;
+        this.allowedOrigins = originsEnv.split(",").map((o) => o.trim());
+    }
+    canActivate(context) {
+        const request = context.switchToHttp().getRequest();
+        const origin = request.headers.origin || request.headers.referer;
+        if (!origin) {
+            return true;
+        }
+        const isAllowed = this.allowedOrigins.some((allowedOrigin) => this.matchesPattern(origin, allowedOrigin));
+        if (!isAllowed) {
+            console.warn(`[OriginValidationGuard] Rejected request from unauthorized origin: ${origin}`);
+        }
+        return isAllowed;
+    }
+    matchesPattern(origin, pattern) {
+        if (origin === pattern) {
+            return true;
+        }
+        if (pattern.includes("*")) {
+            const regexPattern = pattern
+                .replace(/\./g, "\\.")
+                .replace(/\*/g, ".*");
+            const regex = new RegExp(`^${regexPattern}$`);
+            return regex.test(origin);
+        }
+        return false;
+    }
+};
+exports.OriginValidationGuard = OriginValidationGuard;
+exports.OriginValidationGuard = OriginValidationGuard = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], OriginValidationGuard);
+//# sourceMappingURL=origin-validation.guard.js.map

package/dist/http/guards/origin-validation.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin-validation.guard.js","sourceRoot":"","sources":["../../../src/http/guards/origin-validation.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA2E;AAiBpE,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACf,cAAc,CAAW;IAE1C;QACE,MAAM,cAAc,GAClB,+EAA+E,CAAC;QAClF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,cAAc,CAAC;QACjE,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,WAAW,CAAC,OAAyB;QACnC,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAW,CAAC;QAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QAGjE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAC3D,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,CAC3C,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CACV,sEAAsE,MAAM,EAAE,CAC/E,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IASO,cAAc,CAAC,MAAc,EAAE,OAAe;QAEpD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,YAAY,GAAG,OAAO;iBACzB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;iBACrB,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACxB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;YAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAA;AAzDY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;;GACA,qBAAqB,CAyDjC"}

package/dist/main-http.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/main-http.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@nestjs/core");
+const app_module_1 = require("./app.module");
+const bootstrap_1 = require("./bootstrap");
+const origin_validation_guard_1 = require("./http/guards/origin-validation.guard");
+const cli_1 = require("./cli");
+const ngrok_service_1 = require("./services/ngrok.service");
+async function bootstrap() {
+    (0, cli_1.checkForUpdates)();
+    const options = (0, cli_1.parseCliArgs)();
+    process.env.PORT = options.port.toString();
+    process.env.HOST = options.host;
+    process.env.ANKI_CONNECT_URL = options.ankiConnect;
+    const pinoLogger = (0, bootstrap_1.createPinoLogger)(1);
+    const loggerService = (0, bootstrap_1.createLoggerService)(pinoLogger);
+    const app = await core_1.NestFactory.create(app_module_1.AppModule.forHttp(), {
+        logger: loggerService,
+        bufferLogs: true,
+    });
+    app.useGlobalGuards(new origin_validation_guard_1.OriginValidationGuard());
+    await app.listen(options.port, options.host);
+    let ngrokUrl;
+    if (options.ngrok) {
+        try {
+            const ngrokService = new ngrok_service_1.NgrokService();
+            const tunnelInfo = await ngrokService.start(options.port);
+            ngrokUrl = tunnelInfo.publicUrl;
+        }
+        catch (err) {
+            console.error("\n❌ Failed to start ngrok:");
+            console.error(err instanceof Error ? err.message : String(err));
+            console.error("\nServer is still running locally without tunnel.\n");
+        }
+    }
+    (0, cli_1.displayStartupBanner)(options, ngrokUrl);
+}
+bootstrap().catch((err) => {
+    console.error("Failed to start MCP HTTP server:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=main-http.js.map

package/dist/main-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-http.js","sourceRoot":"","sources":["../src/main-http.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,6CAAyC;AACzC,2CAAoE;AACpE,mFAA8E;AAC9E,+BAA4E;AAC5E,4DAAwD;AAExD,KAAK,UAAU,SAAS;IAEtB,IAAA,qBAAe,GAAE,CAAC;IAElB,MAAM,OAAO,GAAG,IAAA,kBAAY,GAAE,CAAC;IAG/B,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAGnD,MAAM,UAAU,GAAG,IAAA,4BAAgB,EAAC,CAAC,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,IAAA,+BAAmB,EAAC,UAAU,CAAC,CAAC;IAGtD,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,sBAAS,CAAC,OAAO,EAAE,EAAE;QACxD,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAGH,GAAG,CAAC,eAAe,CAAC,IAAI,+CAAqB,EAAE,CAAC,CAAC;IAEjD,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAG7C,IAAI,QAA4B,CAAC;IACjC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,4BAAY,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1D,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC;QAClC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAGD,IAAA,0BAAoB,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/main-stdio.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/main-stdio.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@nestjs/core");
+const app_module_1 = require("./app.module");
+const bootstrap_1 = require("./bootstrap");
+async function bootstrap() {
+    const pinoLogger = (0, bootstrap_1.createPinoLogger)(2);
+    const loggerService = (0, bootstrap_1.createLoggerService)(pinoLogger);
+    await core_1.NestFactory.createApplicationContext(app_module_1.AppModule.forStdio(), {
+        logger: loggerService,
+        bufferLogs: true,
+    });
+    pinoLogger.info("MCP STDIO server started successfully");
+    await new Promise(() => { });
+}
+bootstrap().catch((err) => {
+    console.error("Failed to start MCP STDIO server:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=main-stdio.js.map

package/dist/main-stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-stdio.js","sourceRoot":"","sources":["../src/main-stdio.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,6CAAyC;AACzC,2CAAoE;AAEpE,KAAK,UAAU,SAAS;IAEtB,MAAM,UAAU,GAAG,IAAA,4BAAgB,EAAC,CAAC,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,IAAA,+BAAmB,EAAC,UAAU,CAAC,CAAC;IAGtD,MAAM,kBAAW,CAAC,wBAAwB,CAAC,sBAAS,CAAC,QAAQ,EAAE,EAAE;QAC/D,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,UAAU,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAGzD,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp/clients/__mocks__/anki-connect.client.d.ts

@@ -0,0 +1,6 @@
+export declare const AnkiConnectClient: jest.Mock<any, any, any>;
+export declare class AnkiConnectError extends Error {
+    readonly action?: string | undefined;
+    readonly originalError?: string | undefined;
+    constructor(message: string, action?: string | undefined, originalError?: string | undefined);
+}

package/dist/mcp/clients/__mocks__/anki-connect.client.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnkiConnectError = exports.AnkiConnectClient = void 0;
+exports.AnkiConnectClient = jest.fn().mockImplementation(() => ({
+    invoke: jest.fn(),
+}));
+class AnkiConnectError extends Error {
+    action;
+    originalError;
+    constructor(message, action, originalError) {
+        super(message);
+        this.action = action;
+        this.originalError = originalError;
+        this.name = "AnkiConnectError";
+    }
+}
+exports.AnkiConnectError = AnkiConnectError;
+//# sourceMappingURL=anki-connect.client.js.map

package/dist/mcp/clients/__mocks__/anki-connect.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anki-connect.client.js","sourceRoot":"","sources":["../../../../src/mcp/clients/__mocks__/anki-connect.client.ts"],"names":[],"mappings":";;;AACa,QAAA,iBAAiB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC;IACnE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE;CAClB,CAAC,CAAC,CAAC;AAEJ,MAAa,gBAAiB,SAAQ,KAAK;IAGvB;IACA;IAHlB,YACE,OAAe,EACC,MAAe,EACf,aAAsB;QAEtC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAS;QACf,kBAAa,GAAb,aAAa,CAAS;QAGtC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AATD,4CASC"}

package/dist/mcp/clients/anki-connect.client.d.ts

@@ -0,0 +1,15 @@
+import type { IAnkiConfig } from "../config/anki-config.interface";
+export declare class AnkiConnectError extends Error {
+    readonly action?: string | undefined;
+    readonly originalError?: string | undefined;
+    constructor(message: string, action?: string | undefined, originalError?: string | undefined);
+}
+export declare class AnkiConnectClient {
+    private readonly config;
+    private readonly client;
+    private readonly apiVersion;
+    private readonly apiKey?;
+    private readonly logger;
+    constructor(config: IAnkiConfig);
+    invoke<T = any>(action: string, params?: Record<string, any>): Promise<T>;
+}