anki-mcp-server

他の言語で読む: English , 한국어

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の設定

1. Ankiをインストールします。

2. 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 サーバーを登録します。

1. Claude デスクトップ構成ファイルの場所:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. 構成ファイルに次の内容を追加します。

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

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

使い方

1. Anki アプリケーションを実行し、バックグラウンドで実行し続けます。

2. Claude Desktop を起動します。

3. 次のような自然言語コマンドを 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 の問題を通じてご連絡ください。