Scorzeth Anki MCP Server

🚀 Anki MCP サーバー

Anki MCP サーバーは、ローカルで動作する Anki と接続し、カードの復習と作成を提供する MCP サーバーの実装です。このサーバーは、Anki デスクトップアプリケーション と Anki-Connect プラグインを対象に設計されています。

🚀 クイックスタート

この Anki MCP サーバーを使うことで、Anki と連携してカードの復習や作成を行うことができます。以下に、サーバーの利用に必要な情報をまとめます。

✨ 主な機能

🔍 リソース

• 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 (文字列): カードの裏面

💡 ヒント

• high_quality_cards_prompt
  • 高品質なカードを作成するためのガイドを含むヒントです。
  • Andy Matuschak の 如何编写良好的提示 に基づいています。

📦 インストール

依存関係のインストール

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-server": {
      "command": "/path/to/anki-server/build/index.js"
    }
  }
}

デバッグ

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

npm run inspector

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