Anki MCP サーバー

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

特徴

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

Related MCP server: Anki MCP Server

前提条件

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

インストール

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

使用法

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

利用可能なツール

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

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

例

新しいデッキを作成する

{ "name": "createDeck", "arguments": { "name": "My New Deck" } }

メモを追加

{ "name": "addNote", "arguments": { "deckName": "My New Deck", "modelName": "Basic", "fields": { "Front": "What is the capital of France?", "Back": "Paris" }, "tags": ["geography", "europe"] } }

検索ノート

{ "name": "searchNotes", "arguments": { "query": "deck:\"My New Deck\" tag:geography" } }

構成

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

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

トラブルシューティング

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