Nailuogg Anki MCP Server

🚀 Anki MCP サーバー

Anki MCPサーバーは、モデルコンテキストプロトコル（MCP）を用いたサーバーで、大規模言語モデルがAnkiConnectを介してAnkiというフラッシュカードソフトウェアと相互作用できるようにします。

🚀 クイックスタート

Anki MCPサーバーを使用するには、まず以下の前提条件を満たす必要があります。

1. Ankiをインストールします。
2. AnkiにAnkiConnectプラグインをインストールします。

✨ 主な機能

ツール

• list_decks - 利用可能なすべてのAnkiデッキをリストアップします。
• create_deck - 新しいAnkiデッキを作成します。
• create_note - 新しいノート（基本または削除型）を作成します。
• batch_create_notes - 複数のノートを一度に作成します。
• search_notes - Ankiのクエリ構文を使用してノートを検索します。
• get_note_info - ノートの詳細情報を取得します。
• update_note - 既存のノートを更新します。
• delete_note - ノートを削除します。
• list_note_types - 利用可能なすべてのノートタイプをリストアップします。
• create_note_type - 新しいノートタイプを作成します。
• get_note_type_info - 特定のノートタイプの構造情報を取得します。

リソース

• anki://decks/all - 利用可能なすべてのデッキの完全なリスト
• anki://note-types/all - 利用可能なすべてのノートタイプのリスト
• anki://note-types/all-with-schemas - すべてのノートタイプの詳細な構造情報
• anki://note-types/{modelName} - 特定のノートタイプの詳細な構造情報

📦 インストール

設定

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

npm install

2. サーバーをビルドします。

npm run build

3. 開発時に自動的に再構築します。

npm run watch

テスト

テストスイートを実行します。

npm test

これにより、以下の内容がテストされます。

• サーバーの初期化
• AnkiConnectとの通信
• ノート操作（作成/読み取り/更新/削除）
• デッキ管理
• エラー処理

デバッグ

MCPサーバーは標準入出力を介して通信するため、MCPインスペクターの使用をおすすめします。

npm run inspector

これにより、以下のことができるブラウザベースのインターフェースが提供されます。

• MCPメッセージの監視
• ツール呼び出しのテスト
• サーバーログの表示
• 通信問題のデバッグ

💻 使用例

基本的な使用法

1. 新しいデッキを作成します。

「プログラミング」という名前の新しいAnkiデッキを作成する

2. 基本カードを追加します。

「プログラミング」デッキに新しいカードを作成し、表面に「JavaScriptのクロージャとは何ですか？」、裏面に「クロージャは関数と変数の組み合わせで、そのスコープを保持することができます。」と記載する

3. 削除型カードを追加します。

「プログラミング」デッキに新しい削除型カードを作成し、問題に「JavaScriptのクロージャはどのように使用しますか？」、答えに「別の関数の内部に関数を定義し、外部関数の変数をキャプチャすることで実現します。」と記載する

📚 ドキュメント

設定

Claude Desktopとの連携

サーバーをclaude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes","anki-mcp-server"]
    }
  }
}

Clineの設定

サーバーをVSCode設定のcline_mcp_settings.jsonファイルに追加します。

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes","anki-mcp-server"]
    }
  }
}

🤝 貢献ガイド

• コードをコミットする際には、Contributing.mdファイルの規則に従ってください。
• 問題や提案はIssuesページに投稿してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されており、具体的な条項は以下の通りです。

(ここに完全なMITライセンスのテキストが含まれるべきです)