Anki Mcp Server

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

  • Default 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 サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします：

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。