anki-mcp-http 0.8.5 → 0.10.0

package/dist/mcp/primitives/essential/tools/find-notes.tool.d.ts

@@ -11,6 +11,11 @@ export declare class FindNotesTool {
         content: ({
             type: "text";
             text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -18,6 +23,11 @@ export declare class FindNotesTool {
             type: "image";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -25,6 +35,11 @@ export declare class FindNotesTool {
             type: "audio";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -34,6 +49,11 @@ export declare class FindNotesTool {
             type: "resource_link";
             description?: string | undefined;
             mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -41,6 +61,7 @@ export declare class FindNotesTool {
                 src: string;
                 mimeType?: string | undefined;
                 sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
             }[] | undefined;
             title?: string | undefined;
         } | {
@@ -60,12 +81,21 @@ export declare class FindNotesTool {
                     [x: string]: unknown;
                 } | undefined;
             };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
         })[];
         _meta?: {
             [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
         } | undefined;
         structuredContent?: {
             [x: string]: unknown;

package/dist/mcp/primitives/essential/tools/get-cards.tool.d.ts

@@ -0,0 +1,117 @@
+import type { Context } from "@rekog/mcp-nest";
+import { z } from "zod";
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+declare const CardStateEnum: z.ZodEnum<{
+    new: "new";
+    learning: "learning";
+    due: "due";
+    suspended: "suspended";
+    buried: "buried";
+}>;
+type CardState = z.infer<typeof CardStateEnum>;
+export declare class GetCardsTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    getCards({ deck_name, card_state, limit, }: {
+        deck_name?: string;
+        card_state?: CardState;
+        limit?: number;
+    }, context: Context): Promise<{
+        [x: string]: unknown;
+        content: ({
+            type: "text";
+            text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "image";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "audio";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            name: string;
+            type: "resource_link";
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        } | {
+            type: "resource";
+            resource: {
+                uri: string;
+                text: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                uri: string;
+                blob: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+}
+export {};

package/dist/mcp/primitives/essential/tools/get-cards.tool.js

@@ -0,0 +1,118 @@
+"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);
+};
+var GetCardsTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetCardsTool = void 0;
+const common_1 = require("@nestjs/common");
+const mcp_nest_1 = require("@rekog/mcp-nest");
+const zod_1 = require("zod");
+const anki_connect_client_1 = require("../../../clients/anki-connect.client");
+const anki_utils_1 = require("../../../utils/anki.utils");
+const CardStateEnum = zod_1.z.enum(["due", "new", "learning", "suspended", "buried"]);
+const CARD_STATE_QUERY_MAP = {
+    due: "is:due",
+    new: "is:new",
+    learning: "is:learn",
+    suspended: "is:suspended",
+    buried: "is:buried",
+};
+let GetCardsTool = GetCardsTool_1 = class GetCardsTool {
+    ankiClient;
+    logger = new common_1.Logger(GetCardsTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async getCards({ deck_name, card_state = "due", limit, }, context) {
+        try {
+            const cardLimit = Math.min(limit || 10, 50);
+            this.logger.log(`Getting ${card_state} cards from deck: ${deck_name || "all"}, limit: ${cardLimit}`);
+            await context.reportProgress({ progress: 10, total: 100 });
+            const stateQuery = CARD_STATE_QUERY_MAP[card_state];
+            let query = stateQuery;
+            if (deck_name) {
+                const escapedDeckName = deck_name.replace(/"/g, '\\"');
+                query = `"deck:${escapedDeckName}" ${query}`;
+            }
+            const cardIds = await this.ankiClient.invoke("findCards", {
+                query,
+            });
+            if (cardIds.length === 0) {
+                this.logger.log(`No ${card_state} cards found`);
+                await context.reportProgress({ progress: 100, total: 100 });
+                return (0, anki_utils_1.createSuccessResponse)({
+                    success: true,
+                    message: `No ${card_state} cards found`,
+                    cards: [],
+                    total: 0,
+                });
+            }
+            await context.reportProgress({ progress: 50, total: 100 });
+            const selectedCardIds = cardIds.slice(0, cardLimit);
+            const cardsInfo = await this.ankiClient.invoke("cardsInfo", {
+                cards: selectedCardIds,
+            });
+            const cards = cardsInfo.map((card) => {
+                const { front, back } = (0, anki_utils_1.extractCardContent)(card.fields);
+                return {
+                    cardId: card.cardId,
+                    front: front || card.question || "",
+                    back: back || card.answer || "",
+                    deckName: card.deckName,
+                    modelName: card.modelName,
+                    due: card.due || 0,
+                    interval: card.interval || 0,
+                    factor: card.factor || 2500,
+                };
+            });
+            await context.reportProgress({ progress: 100, total: 100 });
+            this.logger.log(`Retrieved ${cards.length} ${card_state} cards out of ${cardIds.length} total`);
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                cards,
+                total: cardIds.length,
+                returned: cards.length,
+                message: `Found ${cardIds.length} ${card_state} cards, returning ${cards.length}`,
+            });
+        }
+        catch (error) {
+            this.logger.error(`Failed to get ${card_state || "due"} cards`, error);
+            return (0, anki_utils_1.createErrorResponse)(error);
+        }
+    }
+};
+exports.GetCardsTool = GetCardsTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "get_cards",
+        description: "Retrieve cards from Anki with flexible filtering by deck and card state. IMPORTANT: Use sync tool FIRST before getting cards to ensure latest data. After getting cards, use present_card to show them one by one to the user",
+        parameters: zod_1.z.object({
+            deck_name: zod_1.z
+                .string()
+                .optional()
+                .describe("Specific deck name to get cards from. If not specified, gets cards from all decks"),
+            card_state: CardStateEnum.default("due").describe("Filter by card state: 'due' (cards due for review), 'new' (never seen), 'learning' (in learning queue), 'suspended' (manually suspended), 'buried' (temporarily hidden)"),
+            limit: zod_1.z
+                .number()
+                .min(1)
+                .max(50)
+                .default(10)
+                .describe("Maximum number of cards to return"),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], GetCardsTool.prototype, "getCards", null);
+exports.GetCardsTool = GetCardsTool = GetCardsTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], GetCardsTool);
+//# sourceMappingURL=get-cards.tool.js.map

package/dist/mcp/primitives/essential/tools/get-cards.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-cards.tool.js","sourceRoot":"","sources":["../../../../../src/mcp/primitives/essential/tools/get-cards.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp/primitives/essential/tools/get-due-cards.tool.d.ts

@@ -12,6 +12,11 @@ export declare class GetDueCardsTool {
         content: ({
             type: "text";
             text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -19,6 +24,11 @@ export declare class GetDueCardsTool {
             type: "image";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -26,6 +36,11 @@ export declare class GetDueCardsTool {
             type: "audio";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -35,6 +50,11 @@ export declare class GetDueCardsTool {
             type: "resource_link";
             description?: string | undefined;
             mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -42,6 +62,7 @@ export declare class GetDueCardsTool {
                 src: string;
                 mimeType?: string | undefined;
                 sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
             }[] | undefined;
             title?: string | undefined;
         } | {
@@ -61,12 +82,21 @@ export declare class GetDueCardsTool {
                     [x: string]: unknown;
                 } | undefined;
             };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
         })[];
         _meta?: {
             [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
         } | undefined;
         structuredContent?: {
             [x: string]: unknown;

package/dist/mcp/primitives/essential/tools/get-tags.tool.d.ts

@@ -0,0 +1,105 @@
+import type { Context } from "@rekog/mcp-nest";
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+export declare class GetTagsTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    getTags({ pattern }: {
+        pattern?: string;
+    }, context: Context): Promise<{
+        [x: string]: unknown;
+        content: ({
+            type: "text";
+            text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "image";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            type: "audio";
+            data: string;
+            mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            name: string;
+            type: "resource_link";
+            description?: string | undefined;
+            mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        } | {
+            type: "resource";
+            resource: {
+                uri: string;
+                text: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            } | {
+                uri: string;
+                blob: string;
+                mimeType?: string | undefined;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+            };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+}

package/dist/mcp/primitives/essential/tools/get-tags.tool.js

@@ -0,0 +1,86 @@
+"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);
+};
+var GetTagsTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetTagsTool = void 0;
+const common_1 = require("@nestjs/common");
+const mcp_nest_1 = require("@rekog/mcp-nest");
+const zod_1 = require("zod");
+const anki_connect_client_1 = require("../../../clients/anki-connect.client");
+const anki_utils_1 = require("../../../utils/anki.utils");
+let GetTagsTool = GetTagsTool_1 = class GetTagsTool {
+    ankiClient;
+    logger = new common_1.Logger(GetTagsTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async getTags({ pattern }, context) {
+        try {
+            this.logger.log(`Retrieving tags from Anki${pattern ? ` (filter: ${pattern})` : ""}`);
+            await context.reportProgress({ progress: 25, total: 100 });
+            const allTags = await this.ankiClient.invoke("getTags");
+            await context.reportProgress({ progress: 75, total: 100 });
+            if (!allTags || allTags.length === 0) {
+                this.logger.log("No tags found");
+                await context.reportProgress({ progress: 100, total: 100 });
+                return (0, anki_utils_1.createSuccessResponse)({
+                    success: true,
+                    message: "No tags found in Anki collection",
+                    tags: [],
+                    total: 0,
+                });
+            }
+            let tags = allTags;
+            if (pattern) {
+                const lowerPattern = pattern.toLowerCase();
+                tags = allTags.filter((tag) => tag.toLowerCase().includes(lowerPattern));
+            }
+            await context.reportProgress({ progress: 100, total: 100 });
+            this.logger.log(`Found ${tags.length} tags${pattern ? ` (filtered from ${allTags.length})` : ""}`);
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                tags: tags,
+                total: tags.length,
+                ...(pattern && { filtered: true, totalUnfiltered: allTags.length }),
+                message: pattern
+                    ? `Found ${tags.length} tags matching "${pattern}" (${allTags.length} total)`
+                    : `Found ${tags.length} tags`,
+            });
+        }
+        catch (error) {
+            this.logger.error("Failed to retrieve tags", error);
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                hint: "Make sure Anki is running and AnkiConnect is installed",
+            });
+        }
+    }
+};
+exports.GetTagsTool = GetTagsTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "getTags",
+        description: "Get all tags in the Anki collection. Use this to discover existing tags before creating notes to maintain consistency and prevent tag duplication (e.g., avoiding 'roman-empire' vs 'roman_empire' vs 'RomanEmpire').",
+        parameters: zod_1.z.object({
+            pattern: zod_1.z
+                .string()
+                .optional()
+                .describe("Optional filter pattern - returns only tags containing this string (case-insensitive)"),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], GetTagsTool.prototype, "getTags", null);
+exports.GetTagsTool = GetTagsTool = GetTagsTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], GetTagsTool);
+//# sourceMappingURL=get-tags.tool.js.map

package/dist/mcp/primitives/essential/tools/get-tags.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tags.tool.js","sourceRoot":"","sources":["../../../../../src/mcp/primitives/essential/tools/get-tags.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp/primitives/essential/tools/list-decks.tool.d.ts

@@ -11,6 +11,11 @@ export declare class ListDecksTool {
         content: ({
             type: "text";
             text: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -18,6 +23,11 @@ export declare class ListDecksTool {
             type: "image";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -25,6 +35,11 @@ export declare class ListDecksTool {
             type: "audio";
             data: string;
             mimeType: string;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -34,6 +49,11 @@ export declare class ListDecksTool {
             type: "resource_link";
             description?: string | undefined;
             mimeType?: string | undefined;
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
@@ -41,6 +61,7 @@ export declare class ListDecksTool {
                 src: string;
                 mimeType?: string | undefined;
                 sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
             }[] | undefined;
             title?: string | undefined;
         } | {
@@ -60,12 +81,21 @@ export declare class ListDecksTool {
                     [x: string]: unknown;
                 } | undefined;
             };
+            annotations?: {
+                audience?: ("user" | "assistant")[] | undefined;
+                priority?: number | undefined;
+                lastModified?: string | undefined;
+            } | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
         })[];
         _meta?: {
             [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
         } | undefined;
         structuredContent?: {
             [x: string]: unknown;