Anki MCP サーバー

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

特徴

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

• 既存のデッキにメモを追加する

• 利用可能なデッキとノートモデルを一覧表示する

• Ankiの検索構文を使用してノートを検索する

• ノートモデルとそのフィールドに関する詳細情報を取得します

• 複数のメモを一括追加

Related MCP server: Anki MCP Server

前提条件

• 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の検索構文を使用してノートを検索する

例

新しいデッキを作成する

{
  "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 )

トラブルシューティング

1. Ankiに接続できません

   • Ankiが起動していることを確認する

   • AnkiConnectアドオンがインストールされ、動作していることを確認します

   • AnkiConnect URL が正しいことを確認します (デフォルト: http://localhost:8765 )

2. AnkiConnect の権限の問題

   • AnkiConnect は、サーバーがカードを追加しようとする際に許可を求める場合があります。Anki 内でポップアップが表示されるかご確認ください。

ライセンス

MITライセンス