anki-mcp-server

鍛冶屋のバッジ

Claude と Anki を接続する Model Context Protocol (MCP) サーバー。自然言語を使用してフラッシュカードを簡単に作成できます。

導入

anki-mcp-server は、Claude と Anki アプリ間の橋渡し役として機能し、両者間の通信を可能にします。これにより、Claude に自然言語コマンドを与えて Anki フラッシュカードを作成および管理できます。例えば、「簡単な日本語の語彙カードを日本語の単語帳に追加して」とリクエストすると、Claude は適切なカードを自動的に作成します。

Related MCP server: Anki MCP Server

要件

Python 3.8以上
Anki 2.1.x以上
AnkiConnectアドオン
Claude Desktop（またはClaude APIにアクセスできる環境）

インストール

1. AnkiとAnkiConnectの設定

Ankiをインストールします。
AnkiConnect アドオンをインストールします。
- Ankiを起動し、上部メニューからTools > Add-ons > Get Add-onsを選択します。
- コード2055492159を入力し、「OK」をクリックします。
- Ankiを再起動する

2. anki-mcp-serverのインストール

# Clone the repository
git clone https://github.com/dhkim0124/anki-mcp-server.git
cd anki-mcp-server

# Create and activate a virtual environment (optional)
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install required packages
pip install -r requirements.txt

構成

クロードデスクトップセットアップ

Claude Desktop 構成ファイルを変更して、MCP サーバーを登録します。

Claude デスクトップ構成ファイルの場所:
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
構成ファイルに次の内容を追加します。

{
  "mcpServers": {
    "anki-mcp": {
      "command": "python",
      "args": ["path/anki_server.py"],
      "env": {}
    }
  }
}

path/anki_server.py anki_server.py ファイルへの絶対パスに置き換えます。

使い方

Anki アプリケーションを実行し、バックグラウンドで実行し続けます。
Claude Desktop を起動します。
次のような自然言語コマンドを Claude に与えることができます。

コマンド例

「簡単な日本語の語彙カードを日本語のデッキに追加する」
「英語の単語『perseverance』の意味と例文を書いたカードを作成しましょう」
「今日学んだプログラミングの概念をカードにまとめる」
「5枚の履歴タイムラインカードを作成する」

Claude はこれらのリクエストを解釈し、MCP サーバーを通じて Anki に適切なカードを作成します。

主な特徴

カード作成機能

基本的な質問と回答形式のカード作成
語学学習カード作成（単語、意味、例文）
自動タグ追加
複数のデッキにカードを追加する

デッキ管理機能

利用可能なデッキリストを表示
新しいデッキを作成する
特定のデッキ内のカードを検索する

トラブルシューティング

接続の問題

Anki が実行中かどうかを確認します。MCP サーバーと通信するには、Anki が実行されている必要があります。
AnkiConnect の確認：AnkiConnect が正しくインストールされていることを確認してください。Web ブラウザでhttp://localhost:8765にアクセスし、「AnkiConnect v.6」というメッセージが表示されていることを確認してください。
ファイアウォール設定: Windows ユーザーは、Anki へのファイアウォールアクセスを許可する必要がある場合があります。

MCP サーバーの問題

ログを確認する: 問題が発生した場合は、サーバーログでエラーメッセージを確認します。
再起動: 問題が解決しない場合は、Anki、Claude Desktop、MCP サーバーを再起動してください。

拡張と貢献

プロジェクトに貢献したい場合は、GitHubリポジトリをフォークしてプルリクエストを送信してください。以下の分野への貢献を歓迎します。

新しいカードタイプのサポート
言語サポートの改善
インターフェースの改善
ドキュメントの改善

ライセンス

このプロジェクトはMITライセンスに基づいて配布されています。詳細はLICENSEファイルをご覧ください。

接触

問題や質問がある場合は、GitHub の問題を通じてご連絡ください。

Anki MCP Server