Anki MCP サーバー

AnkiConnect を介して Anki に接続し、リーチタグ付きカードを取得する、Claude Desktop 用の MCP (Model Context Protocol) サーバー。

特徴

• AnkiConnect API経由でAnkiに接続します

• 「リーチ」タグが付いたカードを取得します

• カードに日付スタンプ付きのレビュータグを追加します

• クロードによる分析のための包括的なカードデータを提供する

• Claude Desktopで使用可能

前提条件

• Ankiをインストールして実行中

• AnkiにAnkiConnectアドオンをインストールする

• Node.jsとnpm

インストール

1. このリポジトリをクローンします:

   git clone https://github.com/yourusername/anki-mcp-server.git cd anki-mcp-server

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

   npm install

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

   npm run build

構成

サーバーは環境変数を使用して設定できます。提供されているサンプルファイルをコピーして、独自の設定を作成してください。

次に、 .envファイルを編集して設定をカスタマイズします。

環境変数が設定されていない場合、サーバーはデフォルト値を使用します。

AnkiConnect のローカル IP アドレスを見つける

localhostへの接続がうまくいかない場合は、代わりにコンピューターのローカル IP アドレスを使用する必要があります.envファイルを次のように設定してください。

ローカル IP アドレスを見つけるには:

• macOS : ターミナルを開き、 ifconfigまたはipconfig getifaddr en0 (WiFi の場合) を実行します。

• Windows : コマンドプロンプトを開き、 ipconfigを実行します。

• Linux : ターミナルを開き、 ip addr showまたはhostname -Iを実行します。

出力で192.168.xxや10.xxxなどの IPv4 アドレスを探します。

テスト構成

テスト用に、別の構成ファイル.env.testが提供されています。

テスト固有の値を設定するには、 .env.testを編集します。

テストモードで実行するには:

使用法

1. AnkiConnectがインストールされた状態でAnkiが動作していることを確認してください

2. MCP サーバーを実行します。

   npm start

Claudeデスクトップの設定

この MCP サーバーを Claude Desktop で使用するには:

1. クロードデスクトップを開く

2. 次の場所にある Claude Desktop 構成ファイルを編集します。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

3. mcpServersセクションに次の構成を追加します。

"path/to/anki-mcp-server"このリポジトリをクローンした実際のパスに置き換えます。

MCPツールの使用

設定が完了すると、Claude で次のツールを使用できるようになります。

使用例

クロードは MCP サーバーを使用してリーチ カードを取得し、分析します。

利用可能なツール

リーチカードを取得する

Anki からリーチとしてタグ付けされたカードを取得します。

パラメータ:

• detailed （オプション、ブール値、デフォルト：true）：包括的なカードデータを返すか、IDのみを返すか

• count (オプション、数値): 返されるランダムカードの数 (デフォルトはすべてのカード)

タグレビュー済みカード

指定したカードに日付入りの「レビュー済み」タグを追加します。これにより、Claude でレビューしたカードを追跡できます。

パラメータ:

• card_ids (必須、数字の配列): レビュー済みとしてタグ付けするカードIDの配列

• custom_tag_prefix (オプション、文字列、デフォルト: "レビュー"): タグのカスタム プレフィックス

タグの形式は見直し_YYYYMMDD (または指定されている場合はカスタムプレフィックス) になります。

Claude での使用例:

トラブルシューティング

• 「Ankiに接続できませんでした」 - Ankiが実行中であり、AnkiConnectが正しくインストールされていることを確認してください

• 「リーチカードが見つかりません」 - Ankiに「リーチ」タグの付いたカードがありません

• localhost との接続の問題- localhostを使用して接続できない場合:

  1. 構成セクションの説明に従ってローカルIPアドレスを見つけます

  2. ANKI_CONNECT_URL=http://YOUR_LOCAL_IP:8765使用するように.envファイルを更新します。

  3. AnkiConnectがあなたのIPアドレスからの接続を許可するように設定されていることを確認してください

  4. これらの変更を行った後、MCPサーバーを再起動します。

• タグが表示されない- tag_reviewed_cardsツールに有効なカード ID を指定していることを確認してください

テストモード

実際の Anki データに影響を与えずにテストするには、モック モードを使用できます。

1. .envファイルでANKI_MOCK_MODE=trueを設定するか、提供されている.env.testファイルを使用します。

2. npm run start:testでサーバーを実行します。

モックモードでは、サーバーはAnkiに実際に接続することなく、Ankiのすべての操作をシミュレートします。これは、データ変更のリスクを負うことなくClaudeとの統合をテストするのに役立ちます。

発達

ホット リロードを使用して開発モードでサーバーを実行するには:

モックモードを有効にした開発の場合:

ライセンス

マサチューセッツ工科大学