Anki MCP Server

🚀 Anki MCP サーバー

AnkiConnect API を通じて、LLM と Anki 理解カードソフトウェアのインタラクションをサポートするモデルコンテキストプロトコル (MCP) サーバーです。

✨ 主な機能

• 新しいデッキを作成する
• 既存のデッキにノートを追加する
• 利用可能なすべてのデッキとノートテンプレートをリストする
• Anki の検索構文を使用してノートを検索する
• ノートテンプレートとそのフィールドの詳細情報を取得する
• 一度に複数のノートを一括追加する

📦 インストール

前提条件

• Node.js (バージョン 14 以上)
• Anki をインストールし、AnkiConnect プラグインをインストールする
• モデルコンテキストプロトコル互換クライアント (例: Anthropic MCP をサポートする Claude) を持っている

インストール手順

1. Anki をインストールし、AnkiConnect プラグインを有効にする:
   • ツール > プラグイン > プラグインを取得 から、コード 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. Anki が実行され、AnkiConnect が有効になっていることを確認する。
2. MCP サーバーを起動する:

   npm start
   

3. MCP クライアント (例: Claude) をこのサーバーに接続する。

高度な使用法

新しいデッキを作成する

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

📚 ドキュメント

利用可能なツール

このサーバーは MCP クライアントに以下のツールを提供します:

• listDecks: Anki 内のすべてのデッキのリストを取得する
• listModels: Anki 内のすべてのノートテンプレート/タイプのリストを取得する
• createDeck: 新しいデッキを作成する
• getModel: 特定のノートテンプレート/タイプの詳細情報を取得する
• addNote: デッキに単一のノートを追加する
• 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 が権限要求を表示する場合があります。関連する権限を許可してください。

以上の手順に従うことで、この MCP サーバーを使用して Anki と LLM のインタラクション機能を実現できます。