Anki Leech Cards

🚀 Anki MCP サーバー

このサーバーは、Claude Desktop 用に設計された Anki MCP（モデルコンテキストプロトコル）サーバーです。AnkiConnect を通じて Anki に接続し、「leech」タグが付いたカードを検索します。

🚀 クイックスタート

Anki MCP サーバーは、Claude Desktop と連携して、Anki 内の「leech」タグ付きカードを効率的に管理するためのサーバーです。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• AnkiConnect API を通じて Anki に接続します。
• 「leech」タグが付いたカードを検索します。
• カードに日付スタンプ付きの見直しタグを追加します。
• Claude が分析するための包括的なカードデータを提供します。
• Claude Desktop と連携可能です。

📦 インストール

前提条件

• Anki がインストールされ、実行されていること（ダウンロード）
• Anki に AnkiConnect プラグインがインストールされていること（プラグイン情報）
• Node.js と npm がインストールされていること

インストール手順

1. リポジトリをクローンします。

git clone <repository-url>

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

📚 ドキュメント

設定方法

環境変数を使用してパラメータを設定します。

ローカル IP アドレスの取得方法

1. Anki を開き、「ツール」メニューを選択します。
2. 「設定」を選択します。
3. 「ネットワーク」タブで「AnkiConnect リッスンアドレス」を確認します。

テストモード

実際の Anki データを変更せずにテストするには、以下の手順を実行します。

1. ANKI_MOCK_MODE=true を設定するか、.env.test ファイルを使用します。
2. サーバーを起動します。

npm run start:test

ツールの使用方法

Leeched カードの取得

クエリパラメータを指定してカードリストを取得します。

見直し済みカードのマーキング

形式は 見直し::YYYYMMDD（接頭辞はカスタマイズ可能）です。

例:

私はこれらのカードをレビューしました。マークしてください：[1234567890, 1234567891]

トラブルシューティング

• 「Anki に接続できません」 - Anki が実行中で、AnkiConnect が正しくインストールされていることを確認してください。
• 「Leeched カードが見つかりません」 - Anki 内に「leech」タグが付いたカードがない可能性があります。
• localhost 接続の問題：
  1. ローカル IP アドレスを見つけます。
  2. .env ファイルを更新し、ANKI_CONNECT_URL=http://YOUR_LOCAL_IP:8765 を設定します。
  3. AnkiConnect がその IP からの接続を許可していることを確認します。
  4. 変更を適用した後、MCP サーバーを再起動します。

開発モード

ホットリロードでサーバーを実行するには：

npm run dev

または、テストモードで開発するには：

npm run dev:test

📄 ライセンス

MIT