Anki MCPサーバー

AnkiConnectを介してLLMがAnkiフラッシュカードソフトウェアと対話できるようにするModel Context Protocol (MCP) サーバーです。

機能

ツール

• 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} - 特定のノートタイプの詳細構造情報

Related MCP server: Anki MCP Server

前提条件

1. システムにAnkiがインストールされていること

2. AnkiにAnkiConnectアドオンがインストールされていること

設定

デスクトップ拡張機能 (.mcpb) によるインストール

このリポジトリはAnthropic Desktop Extensions (MCPB) をサポートしています。Claude Desktopでこのサーバーを使用する最も簡単な方法は、パッケージ化された .mcpb バンドルをインストールすることです。

1. 提供されたスクリプトを使用して、ローカルで .mcpb ファイルを生成します：

npm run pack

2. Claude Desktopの「設定」→「拡張機能」を開き、生成された .mcpb ファイルをドラッグ＆ドロップして「インストール」をクリックします。

これにより manifest.json が検証され、上記のようにインストール可能な .mcpb アーカイブが出力されます。デスクトップ拡張機能の詳細については、Anthropicの発表を参照してください：Desktop Extensions: One-click MCP server installation for Claude Desktop

Claude Desktopでの使用

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

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

カスタムAnkiConnectポートの使用

AnkiConnectが別のポートで実行されている場合は、--port パラメータを使用して指定できます：

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

Clineの設定

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

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

カスタムAnkiConnectポートの使用

Clineの場合も、カスタムポートを指定できます：

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

エージェントスキル (Claude Code)

Ankiスキルをインストールして、Claude CodeにすべてのAnkiツールとワークフローの組み込み知識を与えます：

npx skills add nailuoGG/anki-mcp-server@anki

インストールすると、フラッシュカードの作成、デッキの管理、またはノートのバッチインポートを依頼した際に、Claude Codeが自動的にそのスキルを使用します。

注意: .mcpb パッケージ版をMCPサーバーとして使用しないでください。Electronのメタデータをstdoutに出力するため、MCP stdioプロトコルが壊れます。代わりに npx -y anki-mcp-server を使用してください。

開発

デスクトップ拡張機能 (.mcpb) のパッケージ化

Claude Desktop用の配布可能なデスクトップ拡張機能バンドルを作成します：

npm run pack

これによりプロジェクトがビルドされ、現在のリポジトリから .mcpb アーカイブが生成され、manifest.json が検証されます。Claude Desktopの拡張機能設定にドラッグ＆ドロップしてテストしてください。参照：Desktop Extensions: One-click MCP server installation for Claude Desktop

MCPレジストリへの公開

このサーバーは、新しいバージョンがリリースされると自動的にMCPレジストリに公開されます。公開プロセスには以下が含まれます：

1. 自動CI/CD: GitHub Actionsがリリース成功時にNPMとMCPレジストリの両方に自動公開

2. スキーマ検証: server.json ファイルが公開前にMCPスキーマに対して検証される

3. バージョン同期: package.json、manifest.json、server.json 間でバージョンが同期される

4. 包括的なテスト: 公開前のマルチバージョンNode.jsテスト、リンティング、検証

5. ベータサポート: 新機能テストのための自動ベータリリース

手動検証

MCPサーバーの設定をローカルで検証できます：

npm run validate-mcp

これにより最新のMCPスキーマがダウンロードされ、server.json ファイルが検証されます。

手動公開

手動で公開する必要がある場合は、MCP Publisher CLIを使用できます：

# Install MCP Publisher
curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.1.0/mcp-publisher_1.1.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
chmod +x mcp-publisher
sudo mv mcp-publisher /usr/local/bin/

# Login to MCP Registry
mcp-publisher login github-oidc

# Publish to MCP Registry
mcp-publisher publish

セットアップ

1. 依存関係をインストール：

npm install

2. サーバーをビルド：

npm run build

3. 自動リビルド付きの開発用：

npm run watch

テスト

テストスイートを実行：

npm test

以下をテストします：

• サーバーの初期化

• AnkiConnect通信

• ノート操作（作成/読み取り/更新/削除）

• デッキ管理

• エラーハンドリング

デバッグ

MCPサーバーはstdioを介して通信するため、MCP Inspectorの使用を推奨します：

npm run inspector

ブラウザベースのインターフェースを提供し、以下が可能です：

• MCPメッセージの監視

• ツール呼び出しのテスト

• サーバーログの表示

• 通信問題のデバッグ

使用例

1. 新しいデッキを作成：

Create a new Anki deck called "Programming"

2. 基本カードを追加：

Create an Anki card in the "Programming" deck with:
Front: What is a closure in JavaScript?
Back: A closure is the combination of a function and the lexical environment within which that function was declared.

3. 穴埋めカードを追加：

Create a cloze card in the "Programming" deck with:
Text: In JavaScript, {{c1::const}} declares a block-scoped variable that cannot be {{c2::reassigned}}.

貢献

1. リポジトリをフォーク

2. フィーチャーブランチを作成

3. テストを実行: npm test

4. プルリクエストを送信

スター履歴

クレジット

アイコン提供: macOS Icons

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照