anki-mcp MCP Server

anki-mcp MCP サーバー

AnkiConnect プラグインを介して Anki と連携するサーバーです。

AnkiConnect プラグインを介して Anki と連携する、TypeScript ベースの MCP サーバーです。以下を提供し、MCP の基本概念を示します。

• URI を持つ Anki のデッキとノートモデルを表すリソース
• Anki のノートを作成、管理するツール
• AnkiConnect API との連携

機能

リソース

• anki://decks/{id} URI を介した Anki デッキの一覧表示とアクセス
• anki://models/{id} URI を介したノートモデルの一覧表示とアクセス
• Anki オブジェクトの JSON 表現

ツール

• listDecks - すべてのデッキ名を取得します
• listModels - すべてのノートモデル名を取得します
• getModel - 特定のノートモデルの詳細を取得します
• addNote - 1 件のノートを作成します
  • デッキ名、モデル名、フィールド、タグを指定します
• addNotes - 複数のノートを一括作成します
  • 指定したパラメーターで多数のノートを作成します

開発

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

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": {
      "command": "node",
      "args": ["d:\\anki-mcp-server\\build\\index.js"]
    }
  }
}

デバッグ

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

npm run inspector

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