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のリストを取得します
  • 評価: 「間違っている」、「難しい」、「良い」、「簡単」
  • 提出されたレビューの確認を返します

構成

前提条件

• 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の使用を強くお勧めします。まず、リポジトリをクローンし、依存関係をインストールします。

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

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