anki-mcp

AIアシスタント（Claude Code、Hermes Agentなど）がAnkiConnectを介してAnkiカードを直接作成・管理できるようにする、軽量な**Model Context Protocol（MCP）**アダプターです。

独自のAIアプリは不要です。AIがインテリジェンス層を担い、このサーバーはAnkiへのブリッジにすぎません。

Claude Code / Hermes / ChatGPT
          │  MCP (stdio)
          ▼
    anki-mcp server
          │  AnkiConnect HTTP (localhost:8765)
          ▼
    Anki Desktop + AnkiConnect add-on
          │  sync
          ▼
       AnkiWeb ──► Anki mobile (iOS/Android)

機能

Related MCP server: Anki MCP Server

セットアップ

1. Anki Desktopをインストール

https://apps.ankiweb.net/ からダウンロードしてインストールします。一度起動し、AnkiWebアカウントと同期してモバイル同期が機能するようにします。

2. AnkiConnectアドオンをインストール

AnkiConnectは、Ankiをlocalhost:8765のローカルHTTP APIとして公開します。

オプションA — Ankiアドオンブラウザ（最も簡単）:

1. Ankiで: ツール → アドオン → アドオンを取得…

2. コード 2055492159 を入力してインストール。

オプションB — 手動（Git）:

cd "$APPDATA/Anki2/addons21"           # Windows
# or: ~/.local/share/Anki2/addons21   (Linux)
# or: ~/Library/Application Support/Anki2/addons21  (macOS)

git clone --depth 1 https://github.com/FooSoft/anki-connect.git 2055492159
cd 2055492159
cp plugin/*.py plugin/*.json plugin/*.md .
rm -rf plugin tests .git 2>/dev/null

3. Ankiを再起動します。起動していることを確認:

curl -s http://127.0.0.1:8765 -X POST -d '{"action":"version","version":6}'
# → {"result": 6, "error": null}

3. MCPサーバーを実行

pip install mcp
python server.py

サーバーはstdio経由でMCPを話します。ツールが機能するには、Anki Desktopが（AnkiConnectを読み込んだ状態で）実行されている必要があります。

クライアントでの設定

Hermes Agent

~/.hermes/config.yaml（Windowsでは%USERPROFILE%\AppData\Local\hermes\config.yaml）に追加:

mcp_servers:
  anki:
    command: python
    args:
      - /absolute/path/to/server.py
    timeout: 60
    connect_timeout: 30

その後、セッション内でMCPを再読み込み（/reload-mcp）するか、再起動します。ツールはmcp_anki_*として表示されます。

Claude Code

claude mcp add anki -- python /absolute/path/to/server.py

使い方

接続が完了したら、AIにやりたいことを伝えるだけです:

「System Designデッキにカードを追加して: 表面 = 『一貫性ハッシュが仮想ノードを使うのはなぜ?』、裏面 = 『キーをより均一に分散するため。』」

「さっき話した重要な概念からAnkiカードを作って。」

カード生成ルール（AIの指示にこれらを入れてください）

• 1枚のカードにつき1つの概念。

• 想起を必要とする質問を優先。

• 長すぎる回答は避ける。

• 些細な事実のカードは作成しない。

• 適切な場合は穴埋め（クローズ）カードを使用。

• ソース/トピックのタグを追加。

モバイルへの同期

MCPで作成されたカードは、同期するまでAnki Desktopに保存されます。同期を実行:

• 手動: Anki → 同期（またはYキーを押す）、または

• AnkiConnect経由: curl -s http://127.0.0.1:8765 -X POST -d '{"action":"sync","version":6}'

その後、Ankiモバイルアプリを同期して新しいカードを取得します。

要件

• Python 3.10以上

• mcpパッケージ（pip install mcp）

• Anki Desktop（実行中）

• AnkiConnectアドオン

ライセンス

MIT