anki-mcp-http 0.3.0

package/dist/mcp/primitives/essential/tools/update-note-fields.tool.js

@@ -0,0 +1,154 @@
+"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 UpdateNoteFieldsTool_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateNoteFieldsTool = 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 UpdateNoteFieldsTool = UpdateNoteFieldsTool_1 = class UpdateNoteFieldsTool {
+    ankiClient;
+    logger = new common_1.Logger(UpdateNoteFieldsTool_1.name);
+    constructor(ankiClient) {
+        this.ankiClient = ankiClient;
+    }
+    async updateNoteFields({ note }, context) {
+        try {
+            const fieldCount = Object.keys(note.fields).length;
+            this.logger.log(`Updating ${fieldCount} field(s) for note ID: ${note.id}`);
+            if (fieldCount === 0) {
+                return (0, anki_utils_1.createErrorResponse)(new Error('No fields provided for update'), {
+                    noteId: note.id,
+                    hint: 'Provide at least one field to update',
+                });
+            }
+            await context.reportProgress({ progress: 25, total: 100 });
+            const notesInfo = await this.ankiClient.invoke('notesInfo', {
+                notes: [note.id],
+            });
+            if (!notesInfo || notesInfo.length === 0 || !notesInfo[0]) {
+                return (0, anki_utils_1.createErrorResponse)(new Error('Note not found'), {
+                    noteId: note.id,
+                    hint: 'The note ID is invalid or the note has been deleted. Use findNotes to get valid note IDs.',
+                });
+            }
+            const currentNote = notesInfo[0];
+            const modelName = currentNote.modelName;
+            const existingFields = Object.keys(currentNote.fields);
+            const invalidFields = Object.keys(note.fields).filter(field => !existingFields.includes(field));
+            if (invalidFields.length > 0) {
+                return (0, anki_utils_1.createErrorResponse)(new Error(`Invalid fields for model "${modelName}"`), {
+                    noteId: note.id,
+                    modelName,
+                    invalidFields,
+                    validFields: existingFields,
+                    hint: `These fields don't exist in the "${modelName}" model. Use modelFieldNames to see valid fields.`,
+                });
+            }
+            await context.reportProgress({ progress: 50, total: 100 });
+            const updateParams = {
+                note: {
+                    id: note.id,
+                    fields: note.fields,
+                },
+            };
+            if (note.audio) {
+                updateParams.note.audio = note.audio;
+            }
+            if (note.picture) {
+                updateParams.note.picture = note.picture;
+            }
+            const result = await this.ankiClient.invoke('updateNoteFields', updateParams);
+            await context.reportProgress({ progress: 100, total: 100 });
+            this.logger.log(`Successfully updated note ID: ${note.id}`);
+            const updatedFields = Object.keys(note.fields);
+            return (0, anki_utils_1.createSuccessResponse)({
+                success: true,
+                noteId: note.id,
+                updatedFields,
+                fieldCount,
+                modelName,
+                message: `Successfully updated ${fieldCount} field${fieldCount === 1 ? '' : 's'} in note`,
+                cssNote: 'HTML content is preserved. Model CSS styling remains unchanged.',
+                warning: 'If changes don\'t appear, ensure the note wasn\'t open in Anki browser during update.',
+                hint: 'Use notesInfo to verify the changes or findNotes to locate other notes to update.',
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to update note fields', error);
+            if (error instanceof Error) {
+                if (error.message.includes('not found')) {
+                    return (0, anki_utils_1.createErrorResponse)(error, {
+                        noteId: note.id,
+                        hint: 'Note not found. It may have been deleted.',
+                    });
+                }
+                if (error.message.includes('field')) {
+                    return (0, anki_utils_1.createErrorResponse)(error, {
+                        noteId: note.id,
+                        providedFields: Object.keys(note.fields),
+                        hint: 'Check field names match exactly (case-sensitive). Use notesInfo to see current fields.',
+                    });
+                }
+            }
+            return (0, anki_utils_1.createErrorResponse)(error, {
+                noteId: note.id,
+                hint: 'Make sure Anki is running and the note is not open in the browser',
+            });
+        }
+    }
+};
+exports.UpdateNoteFieldsTool = UpdateNoteFieldsTool;
+__decorate([
+    (0, mcp_nest_1.Tool)({
+        name: 'updateNoteFields',
+        description: 'Update the fields of an existing note. Supports HTML content in fields and preserves CSS styling. ' +
+            'WARNING: Do not view the note in Anki browser while updating, or the fields will not update properly. ' +
+            'Close the browser or switch to a different note before updating. IMPORTANT: Only update notes that the user explicitly asked to modify.',
+        parameters: zod_1.z.object({
+            note: zod_1.z.object({
+                id: zod_1.z
+                    .number()
+                    .describe('The ID of the note to update. Get this from findNotes or notesInfo.'),
+                fields: zod_1.z
+                    .record(zod_1.z.string())
+                    .describe('Fields to update with new content. Only include fields you want to change. ' +
+                    'HTML content is supported. Example: {"Front": "<b>New question</b>", "Back": "New answer"}'),
+                audio: zod_1.z
+                    .array(zod_1.z.object({
+                    url: zod_1.z.string().describe('URL of the audio file'),
+                    filename: zod_1.z.string().describe('Filename to save as'),
+                    fields: zod_1.z.array(zod_1.z.string()).describe('Fields to add audio to'),
+                }))
+                    .optional()
+                    .describe('Optional audio files to add to the note'),
+                picture: zod_1.z
+                    .array(zod_1.z.object({
+                    url: zod_1.z.string().describe('URL of the image'),
+                    filename: zod_1.z.string().describe('Filename to save as'),
+                    fields: zod_1.z.array(zod_1.z.string()).describe('Fields to add image to'),
+                }))
+                    .optional()
+                    .describe('Optional images to add to the note'),
+            }),
+        }),
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], UpdateNoteFieldsTool.prototype, "updateNoteFields", null);
+exports.UpdateNoteFieldsTool = UpdateNoteFieldsTool = UpdateNoteFieldsTool_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [anki_connect_client_1.AnkiConnectClient])
+], UpdateNoteFieldsTool);
+//# sourceMappingURL=update-note-fields.tool.js.map

package/dist/mcp/primitives/essential/tools/update-note-fields.tool.js.map

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

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

@@ -0,0 +1,4 @@
+import { DynamicModule } from '@nestjs/common';
+export declare class McpPrimitivesAnkiGuiModule {
+    static forRoot(): DynamicModule;
+}

package/dist/mcp/primitives/gui/index.js

@@ -0,0 +1,26 @@
+"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 McpPrimitivesAnkiGuiModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpPrimitivesAnkiGuiModule = void 0;
+const common_1 = require("@nestjs/common");
+const MCP_GUI_PRIMITIVES = [];
+let McpPrimitivesAnkiGuiModule = McpPrimitivesAnkiGuiModule_1 = class McpPrimitivesAnkiGuiModule {
+    static forRoot() {
+        return {
+            module: McpPrimitivesAnkiGuiModule_1,
+            providers: MCP_GUI_PRIMITIVES,
+            exports: MCP_GUI_PRIMITIVES,
+        };
+    }
+};
+exports.McpPrimitivesAnkiGuiModule = McpPrimitivesAnkiGuiModule;
+exports.McpPrimitivesAnkiGuiModule = McpPrimitivesAnkiGuiModule = McpPrimitivesAnkiGuiModule_1 = __decorate([
+    (0, common_1.Module)({})
+], McpPrimitivesAnkiGuiModule);
+//# sourceMappingURL=index.js.map

package/dist/mcp/primitives/gui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/primitives/gui/index.ts"],"names":[],"mappings":";;;;;;;;;;AACA,2CAAuD;AAEvD,MAAM,kBAAkB,GAAU,EAEjC,CAAC;AAGK,IAAM,0BAA0B,kCAAhC,MAAM,0BAA0B;IACrC,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,MAAM,EAAE,4BAA0B;YAClC,SAAS,EAAE,kBAAkB;YAC7B,OAAO,EAAE,kBAAkB;SAC5B,CAAC;IACJ,CAAC;CACF,CAAA;AARY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,0BAA0B,CAQtC"}

package/dist/mcp/types/anki.types.d.ts

@@ -0,0 +1,152 @@
+export declare enum CardType {
+    New = 0,
+    Learning = 1,
+    Review = 2,
+    Relearning = 3
+}
+export interface AnkiCard {
+    cardId: number;
+    fields: Record<string, {
+        value: string;
+        order: number;
+    }>;
+    fieldOrder: number;
+    question: string;
+    answer: string;
+    modelName: string;
+    ord: number;
+    deckName: string;
+    css: string;
+    factor?: number;
+    interval?: number;
+    note: number;
+    type: number;
+    queue: number;
+    due?: number;
+    reps?: number;
+    lapses?: number;
+    left?: number;
+    mod?: number;
+    flags?: number;
+    tags?: string[];
+}
+export interface SimplifiedCard {
+    cardId: number;
+    front: string;
+    back: string;
+    deckName: string;
+    modelName: string;
+    due: number;
+    interval: number;
+    factor: number;
+}
+export interface CardPresentation {
+    cardId: number;
+    front: string;
+    back?: string;
+    deckName: string;
+    modelName: string;
+    tags: string[];
+    currentInterval: number;
+    easeFactor: number;
+    reviews: number;
+    lapses: number;
+    cardType: string;
+    noteId: number;
+}
+export interface DeckInfo {
+    name: string;
+    stats?: DeckStats;
+}
+export interface DeckStats {
+    deck_id: number;
+    name: string;
+    new_count: number;
+    learn_count: number;
+    review_count: number;
+    total_new: number;
+    total_cards: number;
+}
+export declare enum CardRating {
+    Again = 1,
+    Hard = 2,
+    Good = 3,
+    Easy = 4
+}
+export interface AnkiConnectRequest {
+    action: string;
+    version: number;
+    params?: Record<string, any>;
+    key?: string;
+}
+export interface AnkiConnectResponse<T = any> {
+    result: T;
+    error: string | null;
+}
+export interface NoteOptions {
+    allowDuplicate?: boolean;
+    duplicateScope?: 'deck' | 'collection';
+    duplicateScopeOptions?: {
+        deckName?: string;
+        checkChildren?: boolean;
+        checkAllModels?: boolean;
+    };
+}
+export interface AddNoteParams {
+    deckName: string;
+    modelName: string;
+    fields: Record<string, string>;
+    tags?: string[];
+    options?: NoteOptions;
+}
+export interface Model {
+    name: string;
+    id: number;
+    css: string;
+    fields: string[];
+}
+export interface NoteInfo {
+    noteId: number;
+    modelName: string;
+    tags: string[];
+    fields: Record<string, {
+        value: string;
+        order: number;
+    }>;
+    cards: number[];
+    mod: number;
+}
+export interface UpdateNoteFieldsParams {
+    note: {
+        id: number;
+        fields: Record<string, string>;
+        audio?: Array<{
+            url: string;
+            filename: string;
+            fields: string[];
+        }>;
+        picture?: Array<{
+            url: string;
+            filename: string;
+            fields: string[];
+        }>;
+    };
+}
+export interface CardTemplate {
+    Name: string;
+    Front: string;
+    Back: string;
+}
+export interface CreateModelParams {
+    modelName: string;
+    inOrderFields: string[];
+    cardTemplates: CardTemplate[];
+    css?: string;
+    isCloze?: boolean;
+}
+export interface UpdateModelStylingParams {
+    model: {
+        name: string;
+        css: string;
+    };
+}

package/dist/mcp/types/anki.types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardRating = exports.CardType = void 0;
+var CardType;
+(function (CardType) {
+    CardType[CardType["New"] = 0] = "New";
+    CardType[CardType["Learning"] = 1] = "Learning";
+    CardType[CardType["Review"] = 2] = "Review";
+    CardType[CardType["Relearning"] = 3] = "Relearning";
+})(CardType || (exports.CardType = CardType = {}));
+var CardRating;
+(function (CardRating) {
+    CardRating[CardRating["Again"] = 1] = "Again";
+    CardRating[CardRating["Hard"] = 2] = "Hard";
+    CardRating[CardRating["Good"] = 3] = "Good";
+    CardRating[CardRating["Easy"] = 4] = "Easy";
+})(CardRating || (exports.CardRating = CardRating = {}));
+//# sourceMappingURL=anki.types.js.map

package/dist/mcp/types/anki.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anki.types.js","sourceRoot":"","sources":["../../../src/mcp/types/anki.types.ts"],"names":[],"mappings":";;;AAOA,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,qCAAO,CAAA;IACP,+CAAY,CAAA;IACZ,2CAAU,CAAA;IACV,mDAAc,CAAA;AAChB,CAAC,EALW,QAAQ,wBAAR,QAAQ,QAKnB;AAqFD,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,6CAAS,CAAA;IACT,2CAAQ,CAAA;IACR,2CAAQ,CAAA;IACR,2CAAQ,CAAA;AACV,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB"}

package/dist/mcp/utils/anki.utils.d.ts

@@ -0,0 +1,19 @@
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { AnkiCard } from '../types/anki.types';
+export declare function cleanHtml(html: string): string;
+export declare function extractCardContent(fields: AnkiCard['fields']): {
+    front: string;
+    back: string;
+};
+export declare function getCardType(type: number): string;
+export declare function getNoteType(modelName: string): string;
+export declare function getRatingDescription(rating: number): string;
+export declare function createSuccessResponse(data: any): CallToolResult;
+export declare function createErrorResponse(error: unknown, context?: Record<string, any>): CallToolResult;
+export declare function formatInterval(days: number): string;
+export declare function parseDeckStats(stats: any): {
+    new_count: number;
+    learn_count: number;
+    review_count: number;
+    total_cards: number;
+};

package/dist/mcp/utils/anki.utils.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanHtml = cleanHtml;
+exports.extractCardContent = extractCardContent;
+exports.getCardType = getCardType;
+exports.getNoteType = getNoteType;
+exports.getRatingDescription = getRatingDescription;
+exports.createSuccessResponse = createSuccessResponse;
+exports.createErrorResponse = createErrorResponse;
+exports.formatInterval = formatInterval;
+exports.parseDeckStats = parseDeckStats;
+const anki_types_1 = require("../types/anki.types");
+const anki_connect_client_1 = require("../clients/anki-connect.client");
+function cleanHtml(html) {
+    return html
+        .replace(/<[^>]*>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\n\s*\n/g, '\n')
+        .trim();
+}
+function extractCardContent(fields) {
+    let front = '';
+    let back = '';
+    if (!fields) {
+        return { front, back };
+    }
+    const frontFieldNames = ['Front', '正面', 'Question', 'Text'];
+    const backFieldNames = ['Back', '背面', 'Answer', 'Extra', 'Back Extra'];
+    for (const fieldName of frontFieldNames) {
+        if (fields[fieldName]) {
+            front = fields[fieldName].value;
+            break;
+        }
+    }
+    for (const fieldName of backFieldNames) {
+        if (fields[fieldName]) {
+            back = fields[fieldName].value;
+            break;
+        }
+    }
+    if (!front && !back) {
+        const fieldEntries = Object.entries(fields)
+            .sort((a, b) => a[1].order - b[1].order);
+        if (fieldEntries.length > 0) {
+            front = fieldEntries[0][1].value;
+        }
+        if (fieldEntries.length > 1) {
+            back = fieldEntries[1][1].value;
+        }
+    }
+    return {
+        front: cleanHtml(front),
+        back: cleanHtml(back)
+    };
+}
+function getCardType(type) {
+    switch (type) {
+        case anki_types_1.CardType.New: return 'new';
+        case anki_types_1.CardType.Learning: return 'learning';
+        case anki_types_1.CardType.Review: return 'review';
+        case anki_types_1.CardType.Relearning: return 'relearning';
+        default: return 'unknown';
+    }
+}
+function getNoteType(modelName) {
+    const lowerName = modelName.toLowerCase();
+    if (lowerName.includes('basic')) {
+        if (lowerName.includes('reverse')) {
+            return 'Basic (and reversed card)';
+        }
+        return 'Basic';
+    }
+    if (lowerName.includes('cloze')) {
+        return 'Cloze';
+    }
+    return 'Custom';
+}
+function getRatingDescription(rating) {
+    switch (rating) {
+        case anki_types_1.CardRating.Again:
+            return 'Again (failed to recall)';
+        case anki_types_1.CardRating.Hard:
+            return 'Hard (recalled with difficulty)';
+        case anki_types_1.CardRating.Good:
+            return 'Good (recalled with some effort)';
+        case anki_types_1.CardRating.Easy:
+            return 'Easy (recalled instantly)';
+        default:
+            return 'Unknown';
+    }
+}
+function createSuccessResponse(data) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+function createErrorResponse(error, context) {
+    const errorData = {
+        success: false,
+        error: error instanceof Error ? error.message : 'Unknown error occurred',
+    };
+    if (error instanceof anki_connect_client_1.AnkiConnectError) {
+        if (error.action) {
+            errorData.action = error.action;
+        }
+    }
+    if (context) {
+        Object.assign(errorData, context);
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(errorData, null, 2),
+            },
+        ],
+        isError: true,
+    };
+}
+function formatInterval(days) {
+    if (days < 1) {
+        const hours = Math.round(days * 24);
+        return `${hours} hour${hours !== 1 ? 's' : ''}`;
+    }
+    if (days < 30) {
+        return `${Math.round(days)} day${days !== 1 ? 's' : ''}`;
+    }
+    if (days < 365) {
+        const months = Math.round(days / 30);
+        return `${months} month${months !== 1 ? 's' : ''}`;
+    }
+    const years = Math.round(days / 365 * 10) / 10;
+    return `${years} year${years !== 1 ? 's' : ''}`;
+}
+function parseDeckStats(stats) {
+    return {
+        new_count: stats.new_count || 0,
+        learn_count: stats.lrn_count || 0,
+        review_count: stats.rev_count || 0,
+        total_cards: stats.total || 0,
+    };
+}
+//# sourceMappingURL=anki.utils.js.map

package/dist/mcp/utils/anki.utils.js.map

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

package/dist/mcp/utils/mcpb-workarounds.d.ts

@@ -0,0 +1 @@
+export declare function sanitizeMcpbConfigValue(value: string | undefined): string | undefined;

package/dist/mcp/utils/mcpb-workarounds.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeMcpbConfigValue = sanitizeMcpbConfigValue;
+function sanitizeMcpbConfigValue(value) {
+    if (!value || value.trim() === '') {
+        return undefined;
+    }
+    if (value.startsWith('${') && value.endsWith('}')) {
+        return undefined;
+    }
+    return value;
+}
+//# sourceMappingURL=mcpb-workarounds.js.map

package/dist/mcp/utils/mcpb-workarounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpb-workarounds.js","sourceRoot":"","sources":["../../../src/mcp/utils/mcpb-workarounds.ts"],"names":[],"mappings":";;AA0BA,0DAWC;AAXD,SAAgB,uBAAuB,CAAC,KAAyB;IAC/D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAGD,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}