Anki MCP Server

Anki MCP サーバー

Claude Desktop 向けの MCP（Model Context Protocol）サーバーです。AnkiConnect 経由で Anki に接続し、leech タグが付いたカードを取得します。

機能

• AnkiConnect API 経由で Anki に接続します
• 「leech」タグが付いたカードを取得します
• 日付入りの見直しタグをカードに追加します
• Claude による分析用に、カードの包括的なデータを提供します
• Claude Desktop で使用できます

前提条件

• Anki がインストールされ、起動していること
• AnkiConnect アドオンが Anki にインストールされていること
• Node.js と npm

インストール

1. このリポジトリをクローンします：

   git clone https://github.com/yourusername/anki-mcp-server.git
   cd anki-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

設定

サーバーは環境変数を使用して設定できます。付属のサンプルファイルをコピーして、独自の設定を作成します：

cp .env.example .env

次に、.env ファイルを編集して設定をカスタマイズします：

環境変数	説明	デフォルト値
ANKI_CONNECT_URL	Anki Connect API の URL	http://localhost:8765
ANKI_CONNECT_VERSION	使用する Anki Connect API のバージョン	6
ANKI_MOCK_MODE	テスト用のモックモードを有効にします（true/false）	false

環境変数が設定されていない場合、サーバーはデフォルト値を使用します。

AnkiConnect 用のローカル IP アドレスを確認する

localhost への接続が機能しない場合は、代わりにコンピューターのローカル IP アドレスを使用する必要があります。.env ファイルを次のように設定します：

ANKI_CONNECT_URL=http://YOUR_LOCAL_IP:8765

ローカル IP アドレスを確認するには：

• macOS：ターミナルを開き、ifconfig または ipconfig getifaddr en0（Wi-Fi の場合）を実行します
• Windows：コマンドプロンプトを開き、ipconfig を実行します
• Linux：ターミナルを開き、ip addr show または hostname -I を実行します

出力から、192.168.x.x や 10.x.x.x のような IPv4 アドレスを探します。

テスト設定

テスト用に、別の設定ファイル .env.test が用意されています：

cp .env.example .env.test

.env.test を編集して、テスト固有の値を設定します：

ANKI_CONNECT_URL=http://localhost:8765
ANKI_CONNECT_VERSION=6
ANKI_MOCK_MODE=true

テストモードで実行するには：

npm run start:test

使用方法

1. AnkiConnect をインストールした状態で Anki が起動していることを確認します
2. MCP サーバーを実行します：

   npm start
   

Claude Desktop の設定

この MCP サーバーを Claude Desktop で使用するには：

1. Claude Desktop を開きます

2. 次の場所にある Claude Desktop の設定ファイルを編集します：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

3. mcpServers セクションに次の設定を追加します：

{
  "mcpServers": {
    "anki": {
      "command": "node",
      "args": ["path/to/anki-mcp-server/dist/index.js"]
    }
  }
}

"path/to/anki-mcp-server" を、このリポジトリをクローンした実際のパスに置き換えます。

MCP ツールの使用方法

設定が完了すると、Claude で次のツールを使用できます：

使用例

Could you analyze my Anki leech cards and suggest ways to improve my study?

Claude は MCP サーバーを使って leech カードを取得し、分析します。

利用可能なツール

get_leech_cards

Anki から leech としてタグ付けされたカードを取得します。

パラメーター：

• detailed（省略可能、ブール値、デフォルト：true）：カードの包括的なデータを返すか、ID のみを返すかを指定します
• count（省略可能、数値）：返すランダムなカードの数（デフォルトではすべてのカード）

tag_reviewed_cards

指定したカードに日付入りの「reviewed」タグを追加します。これにより、Claude と見直したカードを追跡できます。

パラメーター：

• card_ids（必須、数値の配列）：見直し済みとしてタグ付けするカード ID の配列
• custom_tag_prefix（省略可能、文字列、デフォルト：「見直し」）：タグのカスタムプレフィックス

タグは 見直し::YYYYMMDD（または指定したカスタムプレフィックス）という形式になります。

Claude での使用例：

I've reviewed these cards, please tag them as reviewed: [1234567890, 1234567891]

トラブルシューティング

• 「Anki に接続できませんでした」 - Anki が起動しており、AnkiConnect が正しくインストールされていることを確認してください
• 「リーチカードが見つかりません」 - Anki に「leech」タグが付いたカードがありません
• localhost への接続に関する問題 - localhost を使用して接続できない場合：
  1. 「設定」セクションの説明に従って、ローカル IP アドレスを確認します
  2. .env ファイルを更新し、ANKI_CONNECT_URL=http://YOUR_LOCAL_IP:8765 を使用します
  3. AnkiConnect が IP アドレスからの接続を許可するように設定されていることを確認します
  4. これらの変更を行った後、MCP サーバーを再起動します
• タグが表示されない - tag_reviewed_cards ツールに有効なカード ID を指定していることを確認してください

テストモード

実際の Anki データに影響を与えずにテストするには、モックモードを使用できます：

1. .env ファイルで ANKI_MOCK_MODE=true を設定するか、付属の .env.test ファイルを使用します
2. npm run start:test でサーバーを実行します

モックモードでは、サーバーは Anki に実際に接続することなく、すべての Anki 操作をシミュレートします。データを変更するリスクなしに Claude との統合をテストするのに役立ちます。

開発

ホットリロードを有効にして開発モードでサーバーを実行するには：

npm run dev

モックモードを有効にして開発するには：

npm run dev:test

ライセンス

MIT