Anki Cards (Clanki)

🚀 Clanki - Claudeと統合されたAnkiプラグイン

Clankiは、ClaudeのようなAIアシスタントがモデルコンテキストプロトコル（MCP）を通じてAnkiのフラッシュカードライブラリとやり取りできるようにするMCPサーバーです。

✨ 主な機能

• Ankiのカードライブラリを作成および管理する
• 基本的な表裏式のカードを作成する
• 削除機能付きのClozeカードを作成する
• 既存のカードとCloze削除項目を更新する
• タグを追加および管理する
• カードライブラリの内容とカード情報を表示する
• AnkiConnectと完全に統合する

🚀 クイックスタート

前提条件

• Ankiがインストールされ、実行されていること
• AnkiにAnkiConnectプラグインがインストールされ、有効になっていること
• Node.js 16以上がインストールされていること

📦 インストール

1. このリポジトリをクローンします：

git clone https://github.com/yourusername/clanki.git
cd clanki

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

設定手順

1. Ankiが実行されており、AnkiConnectプラグインがインストールされ、有効になっていることを確認します。
2. claude_desktop_config.jsonファイルを編集して、Claude Desktopがこのサーバーを使用するように設定します：

{
  "mcpServers": {
    "clanki": {
      "command": "node",
      "args": ["/absolute/path/to/clanki/build/index.js"]
    }
  }
}

/absolute/path/to/clankiを実際のClankiのインストールパスに置き換えてください。

💻 使用例

利用可能なツール

create - deck

新しいAnkiカードライブラリを作成します。

• パラメータ：
  • name: 新しいカードライブラリの名前

create - card

指定されたカードライブラリに新しい基本的なフラッシュカードを作成します。

• パラメータ：
  • deckName: カードが所属するカードライブラリの名前
  • front: カードの表面の内容
  • back: カードの裏面の内容
  • tags: (オプション) カードのタグ配列

create - cloze - card

指定されたカードライブラリに新しいCloze削除式カードを作成します。

• パラメータ：
  • deckName: カードが所属するカードライブラリの名前
  • text: Cloze削除構文{{c1::text}}を含むテキスト内容
  • backExtra: (オプション) カードの裏面に表示される追加情報
  • tags: (オプション) カードのタグ配列

update - card

既存の基本的なフラッシュカードを更新します。

• パラメータ：
  • noteId: 更新するノートのID
  • front: (オプション) 新しい表面の内容
  • back: (オプション) 新しい裏面の内容
  • tags: (オプション) 新しいタグ配列

update - cloze - card

既存のCloze削除式カードを更新します。

• パラメータ：
  • noteId: 更新するノートのID
  • text: (オプション) Cloze構文を含む新しいテキスト内容
  • backExtra: (オプション) 新しい裏面の追加情報
  • tags: (オプション) 新しいタグ配列

📚 ドキュメント

開発ガイド

サーバーを変更または拡張するには：

1. src/index.tsファイルを変更します。
2. npm run buildを使用してプロジェクトを再構築します。
3. npx @modelcontextprotocol/inspector node build/index.jsを使用してデバッグします。