🧠 アンキMCP

AIでAnkiフラッシュカード体験を変革！このMCP（モデルコンテキストプロトコル）サーバーは、AnkiフラッシュカードコレクションとClaudeなどのAIアシスタントを連携させ、学習教材に関する自然な会話を可能にします。

🚀 何ができるの？

あなたのフラッシュカードコレクション全体を把握し、次のことができる AI チューターがいると想像してください。

📚インタラクティブ学習

• 「3日間見ていない日本語の語彙についてクイズを出してください」

• 「私の医療デッキから挑戦的なカードで私をテストしてください」

• 「最近苦戦しているカードを見せてください」

✨スマートなコンテンツ作成

• 「図を使って光合成についてのフラッシュカードを作成する」

• 「このPDFの章を間隔反復カードに変換します」

• 「講義ノートから穴埋め問題カードを生成する」

🔍強力な分析

• 「私が最も苦労しているのはどのトピックですか？」

• 「先月の勉強パターンを見せてください」

• 「さまざまなカードタイプの保持率はどれくらいですか？」

🎯一括操作

• 「すべての化学カードに『試験準備』のタグを付けます」

• 「定着率の低いカードを集中レビューデッキに移動する」

• 「デッキ全体で重複したカードを見つけて修正する」

Related MCP server: mcp-v8

🎯 機能

• 完全な Anki 統合: 115 の AnkiConnect API メソッドすべてを介してデッキ、カード、メモ、統計に完全にアクセスできます。

• 会話型インターフェース: AIアシスタントを介した自然言語コマンド

• 一括操作：数千枚のカードを一度に効率的に管理

• リアルタイム統計：学習の進捗状況を把握

• メディアサポート: カード内の画像、音声、その他のメディアを処理します

• 高度なクエリ: 複雑な検索条件を使用してカードを検索します

• 型安全性: 包括的なエラー処理を備えた完全に型付けされた API

🛠 技術スタック

• Node.js : ランタイム環境 (18 歳以上必要)

• TypeScript : 型安全性と開発者エクスペリエンス

• MCP SDK : モデルコンテキストプロトコルの実装

• yanki-connect : 🙏完全に型付けされた同型の AnkiConnect API クライアント

• tsup : 高速なTypeScriptバンドラー

• PNPM : 効率的なパッケージマネージャー

この統合を実現する強力な AnkiConnect インターフェースを提供してくれたyanki-connectライブラリに特に感謝します。

📋 前提条件

1. Ankiをインストールする

まだAnkiをダウンロードしてインストールしていない場合は、ダウンロードしてインストールしてください。

2. AnkiConnectプラグインをインストールする

1. Ankiを開く

2. ツール→アドオンへ移動

3. [アドオンを取得...] をクリックします。

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

5. Ankiを再起動する

**📋 バージョン要件：**このサーバーは、完全な互換性のためにAnkiConnectバージョン25.2.25.0以降（2025年2月25日リリース）が必要です。ほとんどの機能は古いバージョンでも動作しますが、最適なエクスペリエンスを得るにはアップデートをお勧めします。

3. AnkiConnect を設定する（オプション）

AnkiConnect はそのまま使用できますが、設定をカスタマイズできます。

1. ツール→アドオンへ移動

2. AnkiConnectを選択し、 Configをクリックします

3. デフォルト設定はほとんどのユーザーにとって問題なく動作するはずです

🚀 クイックスタート

オプション 1: Claude Desktop と併用する (推奨)

1. パッケージをインストールする

   npm install -g @arielbk/anki-mcp

2. Claudeデスクトップの設定

   Claude Desktop 構成ファイルを編集します。

   macOS : ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows : %APPDATA%\Claude\claude_desktop_config.json

   次の構成を追加します。

   {
     "mcpServers": {
       "anki": {
         "command": "anki-mcp",
         "args": []
       }
     }
   }

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

4. ぜひ使い始めてください！

   • AnkiがAnkiConnectを有効にして実行されていることを確認してください

   • クロードに質問する: 「私の Anki デッキを見せて」または「5 枚のカードでクイズを出して」

💡 プロのヒント: *「Anki デッキはいくつありますか?」や「最大のデッキには何が含まれていますか?」*などの簡単な質問を Claude にすることで、設定をテストできます。

オプション2: 開発セットアップ

1. リポジトリをクローンする

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

2. 依存関係をインストールする

   pnpm install

3. プロジェクトを構築する

   pnpm build

4. サーバーをテストする

   # Use the MCP inspector to test functionality
   pnpm inspect

オプション3: 他のMCPクライアントと併用する

このサーバーは、MCP対応のクライアントであればどれでも動作します。また、以下のクライアントでもご利用いただけます。

• MCP Inspector : 対話型デバッグツール

• Cline : AIコーディングのためのVSコード拡張機能

• カスタム MCP クライアント: MCP SDKを使用して独自のクライアントを構築します

stdio トランスポートの場合は、次を実行します。

node dist/index.js

🎮 使用例

Claude Desktop を設定すると、次のような自然な会話が可能になります。

📖 勉強会

You: "I have a Japanese exam tomorrow. Can you quiz me on Hiragana cards I haven't reviewed in a week?"

Claude: I'll find your Hiragana cards that need review and start a quiz session...

📝 コンテンツ作成

You: "Create flashcards for the major battles of World War II with dates and significance"

Claude: I'll create comprehensive flashcards covering the key WWII battles...

📊 学習分析

You: "How am I doing with my medical terminology deck? Show me my weak areas."

Claude: Let me analyze your performance on the medical terminology deck...

🏷️ 組織

You: "Tag all cards about cardiovascular system with 'cardiology' and move them to my MCAT prep deck"

Claude: I'll help you organize those cards...

🔧 利用可能なツールとリソース

この MCP サーバーは、次の機能を通じて Anki コレクションへの包括的なアクセスを提供します。

📚デッキ管理

• 統計情報を含むすべてのデッキを一覧表示する

• 新しいデッキを作成する

• デッキの名前変更と削除

• デッキ構成を取得する

🗂️カード操作

• 検索条件でカードを探す

• 回答カード（復習のシミュレーション）

• カード情報と統計情報を取得する

• カードの一時停止/一時停止解除

• 一括カード操作

📝メモ管理

• カスタムフィールドで新しいメモを追加する

• 既存のメモを更新する

• メモを削除する

• 検索クエリでメモを検索する

• 一括メモ操作

📊統計と分析

• デッキ統計とパフォーマンス指標

• カードの使いやすさと間隔データ

• 履歴とパターンを確認する

• 学習進捗の洞察

🎨メディアとモデル

• ノートの種類とフィールドの定義にアクセスする

• メディアファイル管理

• テンプレートのカスタマイズサポート

🔍高度な機能

• Ankiの検索構文を使用した複雑な検索クエリ

• 効率化のためのバッチ操作

• Ankiとのリアルタイム同期

• エラー処理と検証

• 機能別にグループ化された整理された API メソッド (カード、デッキ、メモ、モデル、統計、メディアなど)

• 完全な型安全性を備えた115のAnkiConnect APIメソッドすべてへの直接アクセス

🛠 開発

# Run in development mode with auto-reloading
pnpm dev

# Lint the code
pnpm lint

# Format the code
pnpm format

# Test with MCP inspector
pnpm inspect

🔧 構成

AnkiConnect 設定

サーバーはデフォルトでlocalhost:8765 AnkiConnect に接続します。AnkiConnect の設定をカスタマイズしている場合は、接続設定を調整する必要があるかもしれません。

重要：MCPサーバーを使用する前に、Ankiが起動していることとAnkiConnectがインストールされていることを確認してください。AnkiConnectにアクセスできない場合、サーバーへの接続は失敗します。

**💡 注:**基盤となるyanki-connectライブラリはmacOSでのAnkiの自動起動をサポートしていますが、この機能は現在MCPサーバーの設定では公開されていません。Ankiを手動で起動する必要があります。

クロードデスクトップの詳細設定

上級ユーザーの場合は、追加のパラメータを渡すことができます。

{
  "mcpServers": {
    "anki": {
      "command": "anki-mcp",
      "args": ["--verbose"],
      "env": {
        "ANKI_CONNECT_HOST": "localhost",
        "ANKI_CONNECT_PORT": "8765"
      }
    }
  }
}

トラブルシューティング

よくある問題:

• 「AnkiConnectへの接続に失敗しました」 : Ankiが実行されており、AnkiConnectプラグインがインストールされていることを確認してください

• 「デッキが見つかりません」 : Ankiに少なくとも1つのデッキがあることを確認してください

• クロードが応答しません: 構成変更後にクロードデスクトップを再起動してください

• 権限エラー: npm list -g @arielbk/anki-mcpでグローバル npm インストールが正しく動作していることを確認してください

🤝 貢献する

貢献を歓迎します！ご協力をお願いします:

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更を加える

4. 該当する場合はテストを追加する

5. プルリクエストを送信する

📜 ライセンス

MIT - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

• yanki-connect - AnkiConnect 用の優れた TypeScript クライアント

• AnkiConnect - Ankiの自動化を可能にするプラグイン

• モデルコンテキストプロトコル- シームレスなAI統合を実現

AIを活用した会話でフラッシュカード体験を変革しましょう！🚀