mcpField
A
Anki MCP

Anki MCP

ローカル
github.com科学・教育02 日前に更新
リポジトリ公式サイト

Anki MCP について

Anki MCPは、AnkiConnectを介してMCPクライアントをAnki Desktopに接続し、AIチャットアプリから学習資料を管理できるようにします。ノートやデッキの操作、カードのプレビュー、メディア、デッキパッケージに対応します。

主な機能

  1. 01ノートの検索、作成、編集
  2. 02デッキとカードの管理
  3. 03カードHTMLとCSSのプレビュー
  4. 04メディアファイルの操作
  5. 05.apkgパッケージのインポートとエクスポート

活用シーン

  1. 01テキストやタグでノートを検索
  2. 02デッキ用の語彙ノートを下書き
  3. 03変更前にカード内容を確認
  4. 04デッキのエクスポートをプレビュー

MCP 対応

ローカルのstdio MCPサーバーが、AnkiConnect経由でAnki Desktopを操作するツールをMCPクライアントに公開します。Anki Desktopを起動し、AnkiConnectを有効にする必要があります。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "ryhus-anki": {
      "command": "npx",
      "args": [
        "-y",
        "@ryhus/anki-mcp"
      ],
      "env": {
        "ANKI_URL": "<ANKI_URL>",
        "ANKI_API_MODE": "<ANKI_API_MODE>",
        "ANKI_REQUEST_TIMEOUT_MS": "<ANKI_REQUEST_TIMEOUT_MS>",
        "ANKI_MEDIA_IMPORT_DIRS": "<ANKI_MEDIA_IMPORT_DIRS>",
        "ANKI_PACKAGE_IMPORT_DIR": "<ANKI_PACKAGE_IMPORT_DIR>",
        "ANKI_PACKAGE_EXPORT_DIR": "<ANKI_PACKAGE_EXPORT_DIR>"
      }
    }
  }
}
起動コマンドnpx -y @ryhus/anki-mcp
設定が必要な環境変数
ANKI_URLAnkiConnect base URL on your computer. Keep Anki Desktop open; omit /api/v1.
ANKI_API_MODEUse v1 for the full tool set with compatible AnkiConnect, or legacy for older add-ons.
ANKI_REQUEST_TIMEOUT_MSRequest deadline in integer milliseconds, including queue wait: 1 to 300000.
ANKI_MEDIA_IMPORT_DIRSOptional trusted local media folders. Separate with : on macOS/Linux or ; on Windows.
ANKI_PACKAGE_IMPORT_DIROptional existing absolute folder for local .apkg imports. Requires API v1.
ANKI_PACKAGE_EXPORT_DIROptional existing absolute folder for local .apkg exports. Requires API v1.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@ryhus/anki-mcp0.1.1

ツール

73

掲載時のツール一覧 · 2 日前に更新

このツールにパラメーターはありません。

詳細

Anki MCP

AI チャットアプリから Anki Desktop を使用できます。ノートの検索、作成、編集、デッキやカードの管理、カードの HTML/CSS のプレビュー、メディアや .apkg デッキパッケージの操作ができます。

MCP クライアントは、チャットに使うアプリであり、Anki Desktop ではありません。ローカル MCP サーバー（stdio サーバーとも呼ばれます）の起動に対応している必要があります。クライアントが Anki MCP を起動し、アシスタントが Anki ツールを使用できるようにします。

クイックスタート

  1. npm とともに Node.js 24 以降をインストールします。
  2. Anki Desktop で、Tools → Add-ons → Get Add-ons を選び、コード 2055492159 を入力して AnkiConnect をインストールします。Anki を再起動し、起動したままにします。
  3. 以下のサーバー設定を MCP クライアントの設定に追加します。クローンやグローバルインストールは不要です。
{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes", "--prefer-online", "--package=@ryhus/anki-mcp@latest", "anki-mcp"],
      "env": {
        "ANKI_URL": "http://127.0.0.1:8765",
        "ANKI_API_MODE": "v1"
      }
    }
  }
}

クライアントに入力フォームがある場合は、Command には npx だけを入力し、4 つのArgumentsを個別に入力して、上記の 2 つのEnvironment variablesを追加します。ANKI_URL は AnkiConnect のアドレスであり、リモート MCP URL ではありません。

クライアントを再読み込みし、**「変更を加えずに Anki のデッキを一覧表示して。」**と尋ねます。

@latest はサーバーの起動時に最新リリースを確認します。実行中のサーバーは更新しません。更新を自分で管理するには、@latest を、たとえば @0.1.0 のような公開済みの正確なバージョンに置き換えます。

試してみる

  • 「a1 タグが付いていて、Haus に言及しているドイツ語のノートを探して。」
  • 「ドイツ語デッキ用の語彙ノートを 3 つ作成して。作成する前に下書きを見せて。」
  • 「変更を加えずに、このカードの表面と裏面の HTML を見せて。」
  • 「復習履歴なしで、ドイツ語デッキのエクスポートをプレビューして。」

設定

  • 互換性のある AnkiConnect ビルドで ANKI_API_MODE=v1 を設定すると、すべてのツールを有効にできます。古いアドオンでは、対応するツールのみを使うために legacy を指定します。
  • ローカルの .apkg のインポートまたはエクスポートを有効にするには、ANKI_PACKAGE_IMPORT_DIR または ANKI_PACKAGE_EXPORT_DIR に、既存の信頼できる絶対パスのフォルダーを設定します。それぞれ個別に有効化でき、ローカルの AnkiConnect v1 が必要です。
  • ディスクからメディアをインポートするには、ANKI_MEDIA_IMPORT_DIRS でソースフォルダーを許可リストに追加します。公開 HTTPS と base64 のソースには、この設定は不要です。

破壊的な変更を承認する前に、プレビューを確認してください。すべてのツールでプレビューが利用できるわけではありません。サーバーはバックアップを作成せず、書き込みを自動で再試行することもありません。エラーが発生した場合は、操作を繰り返す前に Anki を確認してください。

トラブルシューティング

  • クライアントが npx を見つけられない： Node と npm の両方がクライアントの PATH に含まれていることを確認します。Windows でクライアントが shim を必要とする場合は、npx.cmd を使用します。
  • Anki に接続できない： Anki が起動しており、AnkiConnect が有効になっていることを確認します。ANKI_URL には /api/v1 を含めず、ベースアドレスを使用します。
  • パッケージが見つからない： 指定したバージョンが公開済みであることと、クライアントが npm レジストリに接続できることを確認します。

MIT License。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。