Anki MCP Server

🚀 Anki MCP Server

このサーバーは、ローカルで実行されているAnkiに接続し、カードの復習と作成を提供するMCPサーバーの実装です。このサーバーは、AnkiデスクトップアプリとAnki-Connectアドオンと連携するように設計されています。使用する前に、アドオンがインストールされていることを確認してください。

🚀 クイックスタート

このサーバーを使用するには、まずAnki-ConnectアドオンをAnkiデスクトップアプリにインストールする必要があります。その後、以下の手順でサーバーを起動できます。

✨ 主な機能

リソース

• anki://search/deckcurrent
  • 現在のデッキのすべてのカードを返します。
  • Ankiのdeck:currentと同等です。
• anki://search/isdue
  • 復習と学習待ちのカードを返します。
  • Ankiのis:dueと同等です。
• anki://search/isnew
  • 未見のすべてのカードを返します。
  • Ankiのis:newと同等です。

ツール

• update_cards
  • 与えられたカードIDのカードを回答済みとしてマークし、1（Again）から4（Easy）の間の簡単さスコアを付けます。
  • 入力:
    • answers (配列): cardId (数値) と ease (数値) フィールドを持つオブジェクトの配列
• add_card
  • デフォルトのAnkiデッキに新しいカードを作成します。
  • 入力:
    • front (文字列): カードの表面
    • back (文字列): カードの裏面
• get_due_cards
  • 現在復習期限が来ているn枚のカードを返します。
  • 入力:
    • num (数値): カードの枚数
• get_new_cards
  • 新しいカードからn枚のカードを返します。
  • 入力:
    • num (数値): カードの枚数

📦 インストール

依存関係をインストールするには、以下のコマンドを実行します。

npm install

💻 使用例

サーバーのビルド

npm run build

サーバーの起動

npm start

📚 ドキュメント

SSE

SSEのURLは http://localhost:3001/sse です。