Summary

This project provides a Model Context Protocol (MCP) server enabling AI assistants to interact with Anki. It transforms Anki study sessions into dynamic, natural language conversations, allowing AI to explain concepts, create, and edit notes on the fly. It targets Anki users and developers seeking advanced AI integration for personalized learning.

How It Works

The server acts as a bridge between AI assistants and Anki via the AnkiConnect plugin, implementing the MCP specification. It supports local (STDIO) and remote (HTTP) communication modes, offering a modular architecture built on NestJS. A comprehensive suite of over 30 tools allows granular control over Anki operations, facilitating complex AI-driven workflows.

Quick Start & Requirements

• Prerequisites: Anki with AnkiConnect plugin, Node.js 20.19.0+ (or 22.12.0+; Node.js 21.x unsupported).
• Installation:
  • Local (Claude Desktop): Install .mcpb bundle via Claude Desktop extensions.
  • NPM Package: npm install -g @ankimcp/anki-mcp-server, then ankimcp --stdio.
  • HTTP (Web AI): Use npx @ankimcp/anki-mcp-server --ngrok for integrated tunneling.
• Docs: ankimcp.ai.

Highlighted Details

• Extensive Toolset: Offers over 30 granular tools for Anki operations, including batch note creation, media management, and detailed deck statistics.
• AI-Driven Learning: Enables natural language prompts for studying, dynamic note generation, and concept explanations.
• Flexible Deployment: Supports STDIO for desktop clients and HTTP with integrated ngrok for web-based AI assistants.
• Security: Implements input validation for media file paths/URLs to mitigate prompt injection and SSRF vulnerabilities.

Maintenance & Community

Active beta development (v0.15.1) with potential API changes. Primary copyright by Anatoly Tarnavsky. Contact: support@ankimcp.ai. No explicit community forums detailed.

Licensing & Compatibility

Licensed under the permissive MIT License, suitable for commercial and closed-source applications.

Limitations & Caveats

Project is in active beta with evolving APIs. Note updates fail if the note is actively viewed in Anki's browser. Node.js 21.x is unsupported. Secure management of ngrok URLs is crucial for HTTP mode.