mcp-ankiconnect MCP サーバー

MCP を介して Claude の会話を AnkiConnect に接続し、「今日のフラッシュカードを見てみましょう」や「これのフラッシュカードを作ってみましょう」といった間隔をあけた反復学習を簡単に行えるようにします。

コンポーネント

ツール

サーバーは 3 つのツールを実装します。

• num_cards_due_today : 今日期限が切れるカードの数を取得する

  • 特定のデッキでフィルタリングするためのオプションのdeck引数

  • すべてのデッキまたは指定されたデッキの期限付きカードの数を返します

• get_due_cards : レビュー期限が迫っているカードを取得する

  • オプションのlimit引数（デフォルト：5）でカードの数を制御

  • 特定のデッキでフィルタリングするためのオプションのdeck引数

  • 今日のカードのみを表示する場合は、オプションのtoday_only引数（デフォルト：true）を使用します。

  • 質問と回答を含むカードをXML形式で返します

• submit_reviews : レビューしたカードの回答を送信する

  • card_idとrating含むreviewsのリストを取得します

  • 評価: 「間違っている」、「難しい」、「良い」、「簡単」

  • 提出されたレビューの確認を返します

Related MCP server: Anki MCP Server

構成

前提条件

• AnkiはAnkiConnectプラグイン（プラグインID 2055492159）をインストールした状態で実行されている必要があります。MacではAppSleep機能によりAnkiConnectの動作が遅くなる可能性があるため、AnkiではAppSleep機能を無効にしてください。無効にするには、ターミナルで以下のコマンドを実行してください。

  defaults write net.ankiweb.dtop NSAppSleepDisabled -bool true
  defaults write net.ichi2.anki NSAppSleepDisabled -bool true
  defaults write org.qt-project.Qt.QtWebEngineCore NSAppSleepDisabled -bool true

インストール

クイックスタート

1. Anki に AnkiConnect プラグインをインストールします。

   • ツール > アドオン > アドオンを取得...

   • コードを入力してください: 2055492159

   • Ankiを再起動する

2. Claude デスクトップを設定します。

   MacOS の場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

   次の構成を追加します。

   {
     "mcpServers": {
       "mcp-ankiconnect": {
         "command": "uv",
         "args": ["run", "--with", "mcp-ankiconnect", "mcp-ankiconnect"]
       }
     }
   }

3. AnkiとClaudeデスクトップを再起動します

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。まず、リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/samefarrar/mcp-ankiconnect.git
cd mcp-ankiconnect
uv sync

MCP インスペクターは、mcp CLI 経由で起動できます。

uv run mcp dev mcp_ankiconnect/server.py

起動すると、インスペクターにブラウザでアクセスしてデバッグを開始できる URL が表示されます。