Anki MCP Server

🚀 Anki MCP サーバー

Anki MCP サーバーは、ローカルで実行されている Anki インスタンスに接続する MCP（モデルコンテキストプロトコル）サーバーです。カードの復習と作成機能を提供します。

このサーバーは、Anki デスクトップアプリケーション と Anki-Connect プラグインを対象に設計されています。使用する前に、このプラグインをインストールしてください。

🔍 リソース

• anki://search/deckcurrent
  • 現在のデッキ内のすべてのカードを返します。
  • Anki の deck:current と同等です。
• anki://search/isdue
  • 復習待ちの学習カードを返します。
  • Anki の is:due と同等です。
• anki://search/isnew
  • 未見のすべてのカードを返します。
  • Anki の is:new と同等です。

🛠️ ツール

update_cards

• 指定されたカード ID を持つカードを回答済みとしてマークし、1（もう一度見る）から 4（簡単）の難易度評価を付けます。
• 入力:
  • answers (配列): cardId (数値) と ease (数値) フィールドを含むオブジェクトの配列

add_card

• Anki のデフォルトのトップに新しいカードを作成します。
• 入力:
  • front (文字列): カードの表面
  • back (文字列): カードの裏面

get_due_cards

• 現在復習待ちの n 枚のカードを返します。
• 入力:
  • num (数値): カードの枚数

get_new_cards

• 新しいカードから n 枚のカードを取得します。
• 入力:
  • num (数値): カードの枚数

📦 インストール

依存関係のインストール

npm install

サーバーのビルド

npm run build

自動再構築での開発

npm run watch

⚙️ 設定

Claude Desktop と一緒に使用するには、以下の設定を追加してください。

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "anki-mcp-server": {
      "command": "/path/to/anki-mcp-server/build/index.js"
    }
  }
}

デバッグ

MCP サーバーは標準入出力を介して通信するため、デバッグは難しい場合があります。MCP Inspector を使用することをおすすめします。これはパッケージスクリプトとして利用できます。

npm run inspector

Inspector は、ブラウザでアクセスできるデバッグツールの URL を提供します。