Anki Model Context Protocol (MCP) Server

AIアシスタント（Claude Desktop、Claude Code、Antigravity、Codex、Cursor など）が Anki のフラッシュカード、デッキ、ノートタイプ、タグ、メディア、検索を直接管理できる、高性能なModel Context Protocol (MCP) サーバーです。

⚡ ユニバーサルなファイルベース I/O アーキテクチャ

現代のフラッシュカード（特に HTML マークアップ、構文ハイライトされたコードブロック、LaTeX 数式を含むもの）は大きなペイロードです。これらを JSON-RPC ツールのパラメータとしてストリーミングしたり、完全なカード内容をモデルに直接返したりすると、トークン枯渇、出力の切り詰めが引き起こり、コンテキストウィンドウが飽和します。

このサーバーは**ユニバーサルなファイルベースの入出力（File-Based I/O）**を実装します。

1. インバンドトークン肥大化ゼロ: フラッシュカードの変更、クエリ、検索、スキーマの検査は、入力 JSON ファイルのパスを受け取り、完全な構造化出力をディスクへ書き出します。

2. コンパクトなテレメトリ応答: すべてのツール呼び出しは、ステータス、ID、処理件数、解決済みの output_file パスに加え、上限付きのメタデータ概要（$< 150$ tokens）を返します。

3. アトミックな一括取り込み: 数百枚のカードを単一の JSON ペイロードに書き込み、アトミックな SQLite トランザクションで数ミリ秒で取り込めます。

4. クロスプラットフォームな一時保存: 出力はデフォルトで OS の一時ディレクトリ（Windows では %TEMP%\anki_mcp、Linux/macOS では /tmp/anki_mcp）に保存され、ANKI_MCP_OUTPUT_DIR で上書きできます。

Related MCP server: Anki MCP Server

機能

• ⚡ 高速ダイレクトブリッジ: 公式 anki Python エンジンを介して Anki のコレクションデータベース（collection.anki2）へ直接アクセスし、HTTP オーバーヘッドがありません。

• 🔒 非ブロッキングな接続ライフサイクル: リクエストごとにオープン/クローズのコンテキスト管理（~2.7ms）を行い、データベースロックを即座に解放して Anki Desktop をロックアウトしません。

• 🪟 クロスプラットフォーム: Windows、macOS、Linux をネイティブサポートし、標準 OS の場所からコレクションを自動検出します。

• 🗂️ 階層デッキ: ネストしたデッキ作成（例: Computer Science::Algorithms::Trees)）を完全サポートします。

• 📝 リッチなカード形式: 標準カード/基本カード、穴埋め（Cloze）削除（{{c1::...}}）、カスタムフィールド、LaTeX 数式（$...$ と $$...$$）に対応しています。

• 🔍 クエリエンジン: Anki の検索構文（deck:Languages tag:grammar、is:due、added:7、"Recursion"）を完全サポートします。

• 🏷️ タグ管理: 階層的なタグ付けとタグの一括追加、一括削除に対応しています。

• 📦 一括作成: JSON ペイロードによる単一のアトミック操作だけで、大量のカードをまとめて追加できます。

• 💾 デッキエクスポート: .apkg、.colpkg、.json へのネイティブなパッケージ化を提供します。

• 💡 MCP プロンプトとリソース: 組み込みリソース（anki://decks、anki://stats）と構造化カード生成プロンプト（flashcard_generator）を備えています。

インストールと設定

このプロジェクトは、高速で再現可能な Python 環境管理のため、uv を使用しています。

クローンとインストール

git clone https://github.com/debnath-d/anki-mcp-server.git
cd anki-mcp-server
uv sync

サーバーの起動

uv run anki-mcp-server

クライアント設定

1. Claude Desktop

Claude Desktop の設定ファイルにこのサーバーを追加します:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Windows の設定

{
  "mcpServers": {
    "anki": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\path\\to\\anki-mcp-server",
        "run",
        "anki-mcp-server"
      ]
    }
  }
}

macOS / Linux の設定

{
  "mcpServers": {
    "anki": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/anki-mcp-server",
        "run",
        "anki-mcp-server"
      ]
    }
  }
}

2. Google Antigravity

Antigravity の MCP 設定（~/.gemini/config/mcp_config.json）に追加します:

{
  "mcpServers": {
    "anki": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/anki-mcp-server",
        "run",
        "anki-mcp-server"
      ]
    }
  }
}

3. Claude Code / Codex / CLI クライアント

Claude Code を MCP サーバーで起動します:

claude --mcp-server "uv --directory '/path/to/anki-mcp-server' run anki-mcp-server"

提供されている MCP ツール

1. デッキ管理

2. ノートタイプ（モデル）

3. フラッシュカード / ノート管理（ファイルベース）

4. メディア・状態管理・エクスポート

5. 検索と発見

6. タグ管理と統計

テスト

自動テストスイートとリンターを実行します:

ruff check .
uv run python -m unittest discover -s tests

重要な注意点とトラブルシューティング

1. SQLite データベースロック: Anki は排他的なファイルロックを使用します。MCP サーバーが書き込み操作を実行している間は、anki.errors.DBError ロックを防ぐため、Anki デスクトップ GUI アプリケーションを閉じておく必要があります。

2. コレクションパスの自動検出:

   • Windows: %APPDATA%\Anki2\<Profile>\collection.anki2 または %LOCALAPPDATA%\Anki2\<Profile>\collection.anki2 で自動検出されます。

   • macOS: ~/Library/Application Support/Anki2/<Profile>/collection.anki2 で自動検出されます。

   • Linux: ~/.local/share/Anki2/<Profile>/collection.anki2 で自動検出されます。

   • カスタムの場所を使用するには、ANKI_COLLECTION_PATH 環境変数を設定します。

3. 出力キャッシュ: ツールの出力は、デフォルトでは OS の一時ディレクトリ（%TEMP%\anki_mcp または /tmp/anki_mcp）に保存されます。カスタムのディレクトリを使用するには、ANKI_MCP_OUTPUT_DIR を設定します。