Anki MCP サーバー

LLM が AnkiConnect API を介して Anki フラッシュカード ソフトウェアと対話できるようにするモデル コンテキスト プロトコル (MCP) サーバー。

特徴

• Ankiで新しいデッキを作成する
• 既存のデッキにメモを追加する
• 利用可能なデッキとノートモデルを一覧表示する
• Ankiの検索構文を使用してノートを検索する
• ノートモデルとそのフィールドに関する詳細情報を取得します
• 複数のメモを一括追加

前提条件

• Node.js (v14以降)
• AnkiConnectアドオンがインストールされたAnki
• モデルコンテキストプロトコル互換クライアント（Anthropic MCPをサポートするClaudeなど）

インストール

1. AnkiConnectアドオンを使用してAnkiがインストールされていることを確認してください
   • ツール > アドオン > アドオンを取得 に移動し、コード2055492159を入力して AnkiConnect をインストールします。
2. このリポジトリをクローンします:
   git clone https://github.com/yourusername/anki-mcp-server.git cd anki-mcp-server
3. 依存関係をインストールします:
   npm install
4. プロジェクトをビルドします。
   npm run build

使用法

1. AnkiConnectが有効になっているコンピュータでAnkiが動作していることを確認してください
2. MCP サーバーを起動します。
   npm start
3. MCPクライアント（例：Claude）をこのサーバーに接続します

利用可能なツール

サーバーは、MCP クライアントに次のツールを提供します。

• listDecks : Anki のすべてのデッキのリストを取得します
• listModels : Anki のすべてのノートモデル/タイプのリストを取得します。
• createDeck : Ankiで新しいデッキを作成する
• getModel : 特定のノートモデル/タイプに関する詳細を取得します
• addNote : デッキにノートを1つ追加する
• addNotes : 複数のメモを一度に追加する
• searchNotes : Ankiの検索構文を使用してノートを検索する

例

新しいデッキを作成する

メモを追加

検索ノート

構成

サーバー設定はsrc/index.tsのconfigオブジェクトにあります。以下の項目を変更できます。

• ankiConnectUrl : AnkiConnect API の URL (デフォルト: http://localhost:8765 )
• apiVersion : AnkiConnectのAPIバージョン（デフォルト: 6 ）
• defaultDeckName : 指定されていない場合に使用するデフォルトのデッキ (デフォルト: Default )

トラブルシューティング

1. Ankiに接続できません
   • Ankiが起動していることを確認する
   • AnkiConnectアドオンがインストールされ、動作していることを確認します
   • AnkiConnect URL が正しいことを確認します (デフォルト: http://localhost:8765 )
2. AnkiConnect の権限の問題
   • AnkiConnect は、サーバーがカードを追加しようとする際に許可を求める場合があります。Anki 内でポップアップが表示されるかご確認ください。

ライセンス

MITライセンス