@ankimcp/anki-mcp-server 0.8.0

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

@@ -0,0 +1,84 @@
+import type { Context } from "@rekog/mcp-nest";
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+export declare class DeleteNotesTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    deleteNotes({ notes, confirmDeletion }: {
+        notes: number[];
+        confirmDeletion: boolean;
+    }, context: Context): Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            type: "text";
+            text: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            title?: string | undefined;
+            description?: string | undefined;
+            icons?: {
+                [x: string]: unknown;
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+}

package/dist/mcp/primitives/essential/tools/delete-notes.tool.js

@@ -0,0 +1,120 @@
+"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 DeleteNotesTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteNotesTool = 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 DeleteNotesTool = DeleteNotesTool_1 = class DeleteNotesTool {
+    ankiClient;
+    logger = new common_1.Logger(DeleteNotesTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async deleteNotes({ notes, confirmDeletion }, context) {
+        try {
+            if (!confirmDeletion) {
+                return (0, anki_utils_1.createErrorResponse)(new Error("Deletion not confirmed"), {
+                    requestedNotes: notes,
+                    noteCount: notes.length,
+                    hint: "Set confirmDeletion to true to permanently delete these notes and all their cards",
+                    warning: "This action cannot be undone!",
+                });
+            }
+            this.logger.log(`Deleting ${notes.length} note(s)`);
+            await context.reportProgress({ progress: 25, total: 100 });
+            const notesInfo = await this.ankiClient.invoke("notesInfo", {
+                notes: notes,
+            });
+            const validNotes = notesInfo.filter((note) => note && note.noteId);
+            const validNoteIds = validNotes.map((note) => note.noteId);
+            const notFoundCount = notes.length - validNotes.length;
+            if (validNoteIds.length === 0) {
+                this.logger.warn("No valid notes found to delete");
+                await context.reportProgress({ progress: 100, total: 100 });
+                return (0, anki_utils_1.createSuccessResponse)({
+                    success: true,
+                    deletedCount: 0,
+                    notFoundCount: notes.length,
+                    requestedIds: notes,
+                    message: "No notes were deleted (none of the provided IDs were valid)",
+                    hint: "The notes may have already been deleted or the IDs are invalid",
+                });
+            }
+            const totalCards = validNotes.reduce((sum, note) => sum + (note.cards?.length || 0), 0);
+            await context.reportProgress({ progress: 50, total: 100 });
+            await this.ankiClient.invoke("deleteNotes", {
+                notes: validNoteIds,
+            });
+            await context.reportProgress({ progress: 100, total: 100 });
+            this.logger.log(`Successfully deleted ${validNoteIds.length} note(s) and ${totalCards} card(s)`);
+            const message = notFoundCount > 0
+                ? `Successfully deleted ${validNoteIds.length} note(s) and ${totalCards} card(s). ${notFoundCount} note(s) were not found.`
+                : `Successfully deleted ${validNoteIds.length} note(s) and ${totalCards} card(s)`;
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                deletedCount: validNoteIds.length,
+                deletedNoteIds: validNoteIds,
+                cardsDeleted: totalCards,
+                notFoundCount,
+                requestedIds: notes,
+                message: message,
+                warning: "These notes and cards have been permanently deleted",
+                hint: "Consider syncing with AnkiWeb to propagate deletions to other devices",
+            });
+        }
+        catch (error) {
+            this.logger.error("Failed to delete notes", error);
+            if (error instanceof Error) {
+                if (error.message.includes("permission")) {
+                    return (0, anki_utils_1.createErrorResponse)(error, {
+                        requestedNotes: notes,
+                        hint: "Permission denied. Check if Anki allows deletions via AnkiConnect.",
+                    });
+                }
+            }
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                requestedNotes: notes,
+                hint: "Make sure Anki is running and the note IDs are valid",
+            });
+        }
+    }
+};
+exports.DeleteNotesTool = DeleteNotesTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "deleteNotes",
+        description: "Delete notes by their IDs. This will permanently remove the notes and ALL associated cards. " +
+            "This action cannot be undone unless you have a backup. CRITICAL: This is destructive and permanent - only delete notes the user explicitly confirmed for deletion.",
+        parameters: zod_1.z.object({
+            notes: zod_1.z
+                .array(zod_1.z.number())
+                .min(1)
+                .max(100)
+                .describe("Array of note IDs to delete (max 100 at once for safety). " +
+                "Get these IDs from findNotes tool. ALL cards associated with these notes will be deleted."),
+            confirmDeletion: zod_1.z
+                .boolean()
+                .describe("Must be set to true to confirm you want to permanently delete these notes and their cards"),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], DeleteNotesTool.prototype, "deleteNotes", null);
+exports.DeleteNotesTool = DeleteNotesTool = DeleteNotesTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], DeleteNotesTool);
+//# sourceMappingURL=delete-notes.tool.js.map

package/dist/mcp/primitives/essential/tools/delete-notes.tool.js.map

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

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

@@ -0,0 +1,83 @@
+import type { Context } from "@rekog/mcp-nest";
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+export declare class FindNotesTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    findNotes({ query }: {
+        query: string;
+    }, context: Context): Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            type: "text";
+            text: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            title?: string | undefined;
+            description?: string | undefined;
+            icons?: {
+                [x: string]: unknown;
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+}

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

@@ -0,0 +1,106 @@
+"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 FindNotesTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FindNotesTool = 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 FindNotesTool = FindNotesTool_1 = class FindNotesTool {
+    ankiClient;
+    logger = new common_1.Logger(FindNotesTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async findNotes({ query }, context) {
+        try {
+            this.logger.log(`Searching for notes with query: "${query}"`);
+            await context.reportProgress({ progress: 25, total: 100 });
+            const noteIds = await this.ankiClient.invoke("findNotes", {
+                query: query,
+            });
+            await context.reportProgress({ progress: 75, total: 100 });
+            if (!noteIds || noteIds.length === 0) {
+                this.logger.log("No notes found matching the query");
+                await context.reportProgress({ progress: 100, total: 100 });
+                return (0, anki_utils_1.createSuccessResponse)({
+                    success: true,
+                    noteIds: [],
+                    count: 0,
+                    query: query,
+                    message: "No notes found matching the search criteria",
+                    hint: "Try a broader search query or check your deck/tag names",
+                });
+            }
+            await context.reportProgress({ progress: 100, total: 100 });
+            this.logger.log(`Found ${noteIds.length} notes matching the query`);
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                noteIds: noteIds,
+                count: noteIds.length,
+                query: query,
+                message: `Found ${noteIds.length} note${noteIds.length === 1 ? "" : "s"} matching the query`,
+                hint: noteIds.length > 100
+                    ? "Large result set. Consider using notesInfo with smaller batches for detailed information."
+                    : "Use notesInfo tool to get detailed information about these notes",
+            });
+        }
+        catch (error) {
+            this.logger.error("Failed to search for notes", error);
+            if (error instanceof Error) {
+                if (error.message.includes("query")) {
+                    return (0, anki_utils_1.createErrorResponse)(error, {
+                        query,
+                        hint: "Invalid query syntax. Check Anki documentation for valid search syntax.",
+                        examples: [
+                            '"deck:DeckName" - all notes in a deck',
+                            '"tag:important" - notes with specific tag',
+                            '"is:due" - cards that are due for review',
+                            '"added:7" - notes added in last 7 days',
+                            '"front:word" - notes with "word" in front field',
+                        ],
+                    });
+                }
+            }
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                query,
+                hint: "Make sure Anki is running and the query syntax is valid",
+            });
+        }
+    }
+};
+exports.FindNotesTool = FindNotesTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "findNotes",
+        description: "Search for notes using Anki query syntax. Returns an array of note IDs matching the query. " +
+            'Examples: "deck:Spanish", "tag:verb", "is:due", "front:hello", "added:1" (cards added today), ' +
+            '"prop:due<=2" (cards due within 2 days), "flag:1" (red flag), "is:suspended"',
+        parameters: zod_1.z.object({
+            query: zod_1.z
+                .string()
+                .min(1)
+                .describe('Anki search query. Use Anki query syntax like "deck:DeckName", "tag:tagname", ' +
+                '"is:due", "is:new", "is:review", "front:text", "back:text", or combine with spaces for AND, ' +
+                "OR for alternatives. Empty string returns all notes."),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], FindNotesTool.prototype, "findNotes", null);
+exports.FindNotesTool = FindNotesTool = FindNotesTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], FindNotesTool);
+//# sourceMappingURL=find-notes.tool.js.map

package/dist/mcp/primitives/essential/tools/find-notes.tool.js.map

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

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

@@ -0,0 +1,84 @@
+import type { Context } from "@rekog/mcp-nest";
+import { AnkiConnectClient } from "@/mcp/clients/anki-connect.client";
+export declare class GetDueCardsTool {
+    private readonly ankiClient;
+    private readonly logger;
+    constructor(ankiClient: AnkiConnectClient);
+    getDueCards({ deck_name, limit }: {
+        deck_name?: string;
+        limit?: number;
+    }, context: Context): Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            type: "text";
+            text: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            title?: string | undefined;
+            description?: string | undefined;
+            icons?: {
+                [x: string]: unknown;
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+            }[] | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+}

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

@@ -0,0 +1,108 @@
+"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 GetDueCardsTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetDueCardsTool = 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 GetDueCardsTool = GetDueCardsTool_1 = class GetDueCardsTool {
+    ankiClient;
+    logger = new common_1.Logger(GetDueCardsTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async getDueCards({ deck_name, limit }, context) {
+        try {
+            const cardLimit = Math.min(limit || 10, 50);
+            this.logger.log(`Getting due cards from deck: ${deck_name || "all"}, limit: ${cardLimit}`);
+            await context.reportProgress({ progress: 10, total: 100 });
+            let query = "is:due";
+            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 due cards found");
+                await context.reportProgress({ progress: 100, total: 100 });
+                return (0, anki_utils_1.createSuccessResponse)({
+                    success: true,
+                    message: "No cards are due for review",
+                    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 dueCards = 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 ${dueCards.length} due cards out of ${cardIds.length} total`);
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                cards: dueCards,
+                total: cardIds.length,
+                returned: dueCards.length,
+                message: `Found ${cardIds.length} due cards, returning ${dueCards.length}`,
+            });
+        }
+        catch (error) {
+            this.logger.error("Failed to get due cards", error);
+            return (0, anki_utils_1.createErrorResponse)(error);
+        }
+    }
+};
+exports.GetDueCardsTool = GetDueCardsTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: "get_due_cards",
+        description: "Retrieve cards that are due for review from Anki. 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"),
+            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)
+], GetDueCardsTool.prototype, "getDueCards", null);
+exports.GetDueCardsTool = GetDueCardsTool = GetDueCardsTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], GetDueCardsTool);
+//# sourceMappingURL=get-due-cards.tool.js.map

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

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