Captain Blue210 Anki MCP Server

🚀 Anki MCP サーバー

Claude Desktop 用に設計された Model Context Protocol (MCP) サーバーです。AnkiConnect を介して Anki に接続し、「leech」タグ付きのカードを検索します。

🚀 クイックスタート

このサーバーを使用することで、Anki の「leech」タグ付きのカードを取得し、Claude Desktop で分析することができます。以下の手順に従ってサーバーをセットアップしてください。

✨ 主な機能

• AnkiConnect API を通じて Anki に接続します。
• 「leech」タグ付きのカードを検索します。
• カードに日付スタンプ付きの復習タグを追加します。
• Claude が分析するための包括的なカードデータを提供します。
• Claude Desktop と連携して使用できます。

📦 インストール

前提条件

• Anki をインストールし、実行してください。
• Anki 内で AnkiConnect プラグインをインストールしてください。
• Node.js と npm が必要です。

インストール手順

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

   git clone https://github.com/yourusername/anki-mcp-server.git
   cd anki-mcp-server
   

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

   npm install
   

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

   npm run build
   

📚 ドキュメント

設定

サーバーは環境変数を使用して設定できます。提供されているサンプルファイルをコピーして、独自の設定を作成します。

cp .env.example .env

環境変数の説明

使用方法

1. .env ファイルの作成

プロジェクトのルートディレクトリに .env ファイルを作成し、上記の環境変数を追加します。例えば：

ANKI_CONNECT_URL=http://localhost:8765
ANKI_MOCK_MODE=false

2. サーバーの起動

以下のコマンドを実行してサーバーを起動します：

npm start

機能説明

• カードの検索：getLeechCards メソッドを呼び出すことで、「leech」タグ付きのすべてのカードを取得します。
• 復習タグの追加：addReviewTag メソッドを使用して、指定されたカードに日付スタンプ付きの復習タグを追加します。

💻 使用例

基本的な使用法

const { AnkiMCP } = require('anki-mcp');

// 初期化 MCP サーバー
const mcp = new AnkiMCP({
  connectUrl: process.env.ANKI_CONNECT_URL,
  mockMode: process.env.ANKI_MOCK_MODE === 'true'
});

// すべての leech カードを取得
async function getLeechCards() {
  try {
    const cards = await mcp.getLeechCards();
    console.log('取得した leech カード:', cards);
  } catch (error) {
    console.error('カードを取得する際にエラーが発生しました:', error.message);
  }
}

// カードに復習タグを追加
async function addReviewTag(cardId, customPrefix = '見直し') {
  try {
    await mcp.addReviewTag(cardId, customPrefix);
    console.log('カード', cardId, 'に復習タグを追加しました');
  } catch (error) {
    console.error('タグを追加する際にエラーが発生しました:', error.message);
  }
}

// サーバーを起動
async function startServer() {
  try {
    await mcp.start();
    console.log('MCP サーバーが起動し、監視中...');
  } catch (error) {
    console.error('サーバーの起動に失敗しました:', error.message);
  }
}

問題解決

• Anki への接続ができない場合：Anki が実行されており、AnkiConnect プラグインが正常にインストールされていることを確認してください。
• leech カードが見つからない場合：Anki 内に「leech」タグ付きのカードが存在しない可能性があります。
• localhost での接続問題：localhost で接続できない場合は、以下の手順を試してください。
  1. ローカル IP アドレス（例：192.168.x.x または 10.x.x.x）を見つけます。
  2. .env ファイルを更新し、ANKI_CONNECT_URL=http://YOUR_LOCAL_IP:8765 を設定します。
  3. AnkiConnect がその IP からの接続を許可していることを確認します。
  4. 変更を適用した後、MCP サーバーを再起動します。

テストモード

実際のデータを変更せずにテストするには、mock モードを使用します。

1. .env ファイルで ANKI_MOCK_MODE=true を設定するか、提供されている .env.test ファイルを使用します。
2. 以下のコマンドでサーバーを起動します：

   npm run start:test
   

開発モード

開発中にホットリロードを有効にするには：

npm run dev

mock モードでの開発には、以下のコマンドを実行します：

npm run dev:test

📄 ライセンス

MIT