Anki MCP Server

Instructions

Implementation Reference

• src/index.ts:502-522 (registration)

  Registration of the 'tag_reviewed_cards' tool in the ListToolsRequestHandler, including name, description, and input schema

  {
    name: "tag_reviewed_cards",
    description: "Add a 'reviewed on date' tag to specified cards",
    inputSchema: {
      type: "object",
      properties: {
        card_ids: {
          type: "array",
          items: {
            type: "number",
          },
          description: "Array of card IDs to tag as reviewed",
        },
        custom_tag_prefix: {
          type: "string",
          description: "Custom prefix for the tag (default: '見直し')",
        },
      },
      required: ["card_ids"],
    },
  },

• src/index.ts:675-720 (handler)

  Main handler function for executing the 'tag_reviewed_cards' tool logic, validates input, calls AnkiConnect to add tags, and returns success response

  private async handleTagReviewedCards(request: any) {
    const cardIds = request.params.arguments?.card_ids;
    const customTagPrefix = request.params.arguments?.custom_tag_prefix;
  
    // Validate card IDs
    if (!cardIds || !Array.isArray(cardIds) || cardIds.length === 0) {
      return {
        content: [
          {
            type: "text",
            text: "Error: No card IDs provided. Please provide an array of card IDs to tag.",
          },
        ],
        isError: true,
      };
    }
  
    // Add tags to cards
    // addTagsは成功してもresultもerrorもnullなので、例外発生しなければ成功
    await this.ankiClient.addTagsToCards(cardIds, customTagPrefix);
  
    const now = new Date();
    const tagDate = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(
      2,
      "0"
    )}${String(now.getDate()).padStart(2, "0")}`;
    const tagPrefix = customTagPrefix || "見直し";
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(
            {
              message: `Successfully tagged ${cardIds.length} cards with '${tagPrefix}_${tagDate}'`,
              tagged_cards: cardIds,
              tag_added: `${tagPrefix}_${tagDate}`,
              success: true,
            },
            null,
            2
          ),
        },
      ],
    };
  }

• src/index.ts:372-409 (helper)

  Core helper method in AnkiConnectClient that converts card IDs to note IDs, generates date-based tag, and adds the tag via AnkiConnect API

  async addTagsToCards(
    cardIds: number[],
    customTagPrefix?: string
  ): Promise<boolean> {
    if (cardIds.length === 0) {
      console.error("No cards provided to tag");
      return false;
    }
  
    try {
      // First, get the note IDs for the specified cards
      const cardsInfo = await this.request<any[]>("cardsInfo", {
        cards: cardIds,
      });
  
      // Extract unique note IDs
      const noteIds = [...new Set(cardsInfo.map((card) => card.note))];
  
      if (noteIds.length === 0) {
        console.error("Could not find note IDs for the provided card IDs");
        return false;
      }
  
      // Generate the tag with current date
      const reviewedTag = this.generateReviewedTag(customTagPrefix);
  
      // Add the tag to all notes
      const result = await this.request<boolean>("addTags", {
        notes: noteIds,
        tags: reviewedTag,
      });
  
      return result;
    } catch (error) {
      console.error("Error adding tags to cards:", error);
      throw error;
    }
  }

• src/index.ts:347-353 (helper)

  Helper method to generate the date-based reviewed tag string used by addTagsToCards

  private generateReviewedTag(customPrefix: string = "見直し"): string {
    const now = new Date();
    const year = now.getFullYear();
    const month = String(now.getMonth() + 1).padStart(2, "0");
    const day = String(now.getDate()).padStart(2, "0");
    return `${customPrefix}::${year}${month}${day}`;
  }