anki-mcp-http 0.3.0

package/dist/app.module.js

@@ -0,0 +1,74 @@
+"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-desktop',
+                    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(),
+            ],
+            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-desktop',
+                    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(),
+            ],
+            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,kBAAkB;oBACvD,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,EAAE;aACrC;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,kBAAkB;oBACvD,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,EAAE;aACrC;YACD,SAAS,EAAE,CAAC,uCAAiB,CAAC;SAC/B,CAAC;IACJ,CAAC;CACF,CAAA;AAzEY,8BAAS;oBAAT,SAAS;IADrB,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,SAAS,CAyErB"}

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,7 @@
+export interface CliOptions {
+    port: number;
+    host: string;
+    ankiConnect: string;
+}
+export declare function parseCliArgs(): CliOptions;
+export declare function displayStartupBanner(options: CliOptions): void;

package/dist/cli.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCliArgs = parseCliArgs;
+exports.displayStartupBanner = displayStartupBanner;
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const path_1 = require("path");
+function getVersion() {
+    try {
+        const packageJson = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, '../package.json'), 'utf-8'));
+        return packageJson.version;
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+function parseCliArgs() {
+    const program = new commander_1.Command();
+    program
+        .name('ankimcp')
+        .description('AnkiMCP HTTP Server - Model Context Protocol server for Anki')
+        .version(getVersion())
+        .option('-p, --port <number>', 'Port to listen on', '3000')
+        .option('-h, --host <address>', 'Host to bind to', '127.0.0.1')
+        .option('-a, --anki-connect <url>', 'AnkiConnect URL', 'http://localhost:8765')
+        .addHelpText('after', `
+Examples:
+  $ 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
+
+Usage with ngrok:
+  1. Start ankimcp in one terminal
+  2. In another terminal: ngrok http 3000
+  3. Share the ngrok URL with your AI assistant
+`);
+    program.parse();
+    const options = program.opts();
+    return {
+        port: parseInt(options.port.toString(), 10),
+        host: options.host,
+        ankiConnect: options.ankiConnect,
+    };
+}
+function displayStartupBanner(options) {
+    console.log(`
+╔════════════════════════════════════════════════════════════════╗
+║                    AnkiMCP HTTP Server                         ║
+╚════════════════════════════════════════════════════════════════╝
+
+🚀 Server running on: http://${options.host}:${options.port}
+🔌 AnkiConnect URL:   ${options.ankiConnect}
+
+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)
+
+Usage with ngrok:
+  1. In another terminal: ngrok http ${options.port}
+  2. Share the ngrok URL with your AI assistant
+
+Run 'ankimcp --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":";;AAqBA,oCAuCC;AAED,oDAqBC;AAnFD,yCAAoC;AACpC,2BAAkC;AAClC,+BAA4B;AAQ5B,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAC1D,CAAC;QACF,OAAO,WAAW,CAAC,OAAO,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAgB,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,SAAS,CAAC;SACf,WAAW,CAAC,8DAA8D,CAAC;SAC3E,OAAO,CAAC,UAAU,EAAE,CAAC;SACrB,MAAM,CAAC,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,CAAC;SAC1D,MAAM,CAAC,sBAAsB,EAAE,iBAAiB,EAAE,WAAW,CAAC;SAC9D,MAAM,CACL,0BAA0B,EAC1B,iBAAiB,EACjB,uBAAuB,CACxB;SACA,WAAW,CACV,OAAO,EACP;;;;;;;;;;;CAWL,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;KACjC,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAmB;IACtD,OAAO,CAAC,GAAG,CAAC;;;;;+BAKiB,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI;wBACnC,OAAO,CAAC,WAAW;;;0BAGjB,OAAO,CAAC,IAAI;0BACZ,OAAO,CAAC,IAAI;0BACZ,OAAO,CAAC,WAAW;;;;uCAIN,OAAO,CAAC,IAAI;;;;CAIlD,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,27 @@
+"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");
+async function bootstrap() {
+    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);
+    (0, cli_1.displayStartupBanner)(options);
+}
+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,+BAA2D;AAE3D,KAAK,UAAU,SAAS;IACtB,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,IAAA,0BAAoB,EAAC,OAAO,CAAC,CAAC;AAChC,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>;
+}

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

@@ -0,0 +1,145 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var AnkiConnectClient_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnkiConnectClient = exports.AnkiConnectError = void 0;
+const common_1 = require("@nestjs/common");
+const ky_1 = __importStar(require("ky"));
+const anki_config_interface_1 = require("../config/anki-config.interface");
+class AnkiConnectError extends Error {
+    action;
+    originalError;
+    constructor(message, action, originalError) {
+        super(message);
+        this.action = action;
+        this.originalError = originalError;
+        this.name = 'AnkiConnectError';
+    }
+}
+exports.AnkiConnectError = AnkiConnectError;
+let AnkiConnectClient = AnkiConnectClient_1 = class AnkiConnectClient {
+    config;
+    client;
+    apiVersion;
+    apiKey;
+    logger = new common_1.Logger(AnkiConnectClient_1.name);
+    constructor(config) {
+        this.config = config;
+        this.apiVersion = config.ankiConnectApiVersion;
+        this.apiKey = config.ankiConnectApiKey;
+        this.client = ky_1.default.create({
+            prefixUrl: config.ankiConnectUrl,
+            timeout: config.ankiConnectTimeout,
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            retry: {
+                limit: 2,
+                methods: ['POST'],
+                statusCodes: [408, 413, 429, 500, 502, 503, 504],
+                backoffLimit: 3000,
+            },
+            hooks: {
+                beforeRequest: [
+                    (request) => {
+                        this.logger.debug(`AnkiConnect request: ${request.method} ${request.url}`);
+                    },
+                ],
+                afterResponse: [
+                    (_request, _options, response) => {
+                        this.logger.debug(`AnkiConnect response: ${response.status} ${response.statusText}`);
+                    },
+                ],
+            },
+        });
+    }
+    async invoke(action, params) {
+        const request = {
+            action,
+            version: this.apiVersion,
+            params,
+        };
+        if (this.apiKey) {
+            request.key = this.apiKey;
+        }
+        try {
+            this.logger.log(`Invoking AnkiConnect action: ${action}`);
+            const response = await this.client
+                .post('', {
+                json: request,
+            })
+                .json();
+            if (response.error) {
+                throw new AnkiConnectError(`AnkiConnect error: ${response.error}`, action, response.error);
+            }
+            this.logger.log(`AnkiConnect action successful: ${action}`);
+            return response.result;
+        }
+        catch (error) {
+            if (error instanceof ky_1.HTTPError) {
+                if (error.response.status === 403) {
+                    throw new AnkiConnectError('Permission denied. Please check AnkiConnect configuration and API key.', action);
+                }
+                throw new AnkiConnectError(`HTTP error ${error.response.status}: ${error.message}`, action);
+            }
+            if (error instanceof Error && error.message.includes('fetch')) {
+                throw new AnkiConnectError('Cannot connect to Anki. Please ensure Anki is running and AnkiConnect plugin is installed.', action);
+            }
+            if (error instanceof AnkiConnectError) {
+                throw error;
+            }
+            throw new AnkiConnectError(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`, action);
+        }
+    }
+};
+exports.AnkiConnectClient = AnkiConnectClient;
+exports.AnkiConnectClient = AnkiConnectClient = AnkiConnectClient_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(anki_config_interface_1.ANKI_CONFIG)),
+    __metadata("design:paramtypes", [Object])
+], AnkiConnectClient);
+//# sourceMappingURL=anki-connect.client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anki-connect.client.js","sourceRoot":"","sources":["../../../src/mcp/clients/anki-connect.client.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA4D;AAC5D,yCAA+C;AAC/C,2EAA8D;AAO9D,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;AAMM,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAMsB;IALjC,MAAM,CAAa;IACnB,UAAU,CAAS;IACnB,MAAM,CAAU;IAChB,MAAM,GAAG,IAAI,eAAM,CAAC,mBAAiB,CAAC,IAAI,CAAC,CAAC;IAE7D,YAAkD,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;QACnE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,qBAAqB,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAGvC,IAAI,CAAC,MAAM,GAAG,YAAE,CAAC,MAAM,CAAC;YACtB,SAAS,EAAE,MAAM,CAAC,cAAc;YAChC,OAAO,EAAE,MAAM,CAAC,kBAAkB;YAClC,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,KAAK,EAAE;gBACL,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,CAAC,MAAM,CAAC;gBACjB,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;gBAChD,YAAY,EAAE,IAAI;aACnB;YACD,KAAK,EAAE;gBACL,aAAa,EAAE;oBACb,CAAC,OAAO,EAAE,EAAE;wBACV,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,wBAAwB,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CACxD,CAAC;oBACJ,CAAC;iBACF;gBACD,aAAa,EAAE;oBACb,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;wBAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,yBAAyB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAClE,CAAC;oBACJ,CAAC;iBACF;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAQD,KAAK,CAAC,MAAM,CACV,MAAc,EACd,MAA4B;QAE5B,MAAM,OAAO,GAAuB;YAClC,MAAM;YACN,OAAO,EAAE,IAAI,CAAC,UAAU;YACxB,MAAM;SACP,CAAC;QAGF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;YAE1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM;iBAC/B,IAAI,CAAC,EAAE,EAAE;gBACR,IAAI,EAAE,OAAO;aACd,CAAC;iBACD,IAAI,EAA0B,CAAC;YAGlC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,MAAM,IAAI,gBAAgB,CACxB,sBAAsB,QAAQ,CAAC,KAAK,EAAE,EACtC,MAAM,EACN,QAAQ,CAAC,KAAK,CACf,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAC;YAC5D,OAAO,QAAQ,CAAC,MAAM,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAEf,IAAI,KAAK,YAAY,cAAS,EAAE,CAAC;gBAC/B,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAClC,MAAM,IAAI,gBAAgB,CACxB,wEAAwE,EACxE,MAAM,CACP,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,gBAAgB,CACxB,cAAc,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE,EACvD,MAAM,CACP,CAAC;YACJ,CAAC;YAGD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,gBAAgB,CACxB,4FAA4F,EAC5F,MAAM,CACP,CAAC;YACJ,CAAC;YAGD,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;gBACtC,MAAM,KAAK,CAAC;YACd,CAAC;YAGD,MAAM,IAAI,gBAAgB,CACxB,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC7E,MAAM,CACP,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAA;AAtHY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;IAOE,WAAA,IAAA,eAAM,EAAC,mCAAW,CAAC,CAAA;;GANrB,iBAAiB,CAsH7B"}

package/dist/mcp/config/anki-config.interface.d.ts

@@ -0,0 +1,7 @@
+export interface IAnkiConfig {
+    ankiConnectUrl: string;
+    ankiConnectApiVersion: number;
+    ankiConnectApiKey?: string;
+    ankiConnectTimeout: number;
+}
+export declare const ANKI_CONFIG: unique symbol;

package/dist/mcp/config/anki-config.interface.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ANKI_CONFIG = void 0;
+exports.ANKI_CONFIG = Symbol('ANKI_CONFIG');
+//# sourceMappingURL=anki-config.interface.js.map

package/dist/mcp/config/anki-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anki-config.interface.js","sourceRoot":"","sources":["../../../src/mcp/config/anki-config.interface.ts"],"names":[],"mappings":";;;AAgCa,QAAA,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC"}

package/dist/mcp/primitives/essential/index.d.ts

@@ -0,0 +1,30 @@
+export { ANKI_CONFIG } from '../../config/anki-config.interface';
+export type { IAnkiConfig } from '../../config/anki-config.interface';
+export * from '../../types/anki.types';
+export * from '../../utils/anki.utils';
+export { AnkiConnectClient, AnkiConnectError } from '../../clients/anki-connect.client';
+export { SyncTool } from './tools/sync.tool';
+export { ListDecksTool } from './tools/list-decks.tool';
+export { CreateDeckTool } from './tools/create-deck.tool';
+export { GetDueCardsTool } from './tools/get-due-cards.tool';
+export { PresentCardTool } from './tools/present-card.tool';
+export { RateCardTool } from './tools/rate-card.tool';
+export { ModelNamesTool } from './tools/model-names.tool';
+export { ModelFieldNamesTool } from './tools/model-field-names.tool';
+export { ModelStylingTool } from './tools/model-styling.tool';
+export { CreateModelTool } from './tools/create-model.tool';
+export { UpdateModelStylingTool } from './tools/update-model-styling.tool';
+export { AddNoteTool } from './tools/add-note.tool';
+export { FindNotesTool } from './tools/find-notes.tool';
+export { NotesInfoTool } from './tools/notes-info.tool';
+export { UpdateNoteFieldsTool } from './tools/update-note-fields.tool';
+export { DeleteNotesTool } from './tools/delete-notes.tool';
+export { ReviewSessionPrompt } from './prompts/review-session.prompt';
+export { SystemInfoResource } from './resources/system-info.resource';
+import { DynamicModule, Provider } from '@nestjs/common';
+export interface McpPrimitivesAnkiEssentialModuleOptions {
+    ankiConfigProvider: Provider;
+}
+export declare class McpPrimitivesAnkiEssentialModule {
+    static forRoot(options: McpPrimitivesAnkiEssentialModuleOptions): DynamicModule;
+}