Anki MCP Server

@captain-blue210

关于 Anki MCP Server

暂无概览

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "anki": {
      "command": "node",
      "args": [
        "path/to/anki-mcp-server/dist/index.js"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Anki MCP Server?

An MCP (Model Context Protocol) server for Claude Desktop that connects to Anki via AnkiConnect and retrieves leech-tagged cards for AI analysis.

How to use Anki MCP Server?

Install Anki with the AnkiConnect add‑on, clone the repository, install dependencies (npm install), build (npm run build), configure the .env file (optional), run npm start, and add the server to Claude Desktop’s claude_desktop_config.json. Use tools such as get_leech_cards and tag_reviewed_cards via Claude.

Key features of Anki MCP Server

Connects to Anki via the AnkiConnect API
Retrieves cards tagged as “leech”
Adds date‑stamped “reviewed” tags to cards
Provides comprehensive card data for Claude analysis
Supports mock mode for testing without affecting real data

Use cases of Anki MCP Server

Analyze leech cards to uncover study weaknesses
Tag reviewed cards to track progress with Claude
Test Claude integrations safely using mock mode

FAQ from Anki MCP Server

How does Anki MCP Server connect to Anki?

It uses the AnkiConnect add‑on, which must be installed in Anki, and communicates via HTTP (default http://localhost:8765).

What are the prerequisites for Anki MCP Server?

Anki running with the AnkiConnect add‑on, Node.js, and npm.

Can I test the server without affecting my real Anki data?

Yes. Set ANKI_MOCK_MODE=true in the .env file or use the provided .env.test configuration and run npm run start:test. All operations are simulated.

What if I get connection errors when starting the server?

If localhost fails, find your computer’s local IP address (e.g., 192.168.x.x), update ANKI_CONNECT_URL to http://YOUR_LOCAL_IP:8765, and ensure AnkiConnect allows connections from that IP.

What tools does Anki MCP Server expose to Claude?

Two tools: get_leech_cards (with optional detailed and count parameters) and tag_reviewed_cards (with required card_ids and optional custom_tag_prefix).

常见问题

How does Anki MCP Server connect to Anki?

It uses the AnkiConnect add‑on, which must be installed in Anki, and communicates via HTTP (default `http://localhost:8765`).

What are the prerequisites for Anki MCP Server?

Anki running with the AnkiConnect add‑on, Node.js, and npm.

Can I test the server without affecting my real Anki data?

Yes. Set `ANKI_MOCK_MODE=true` in the `.env` file or use the provided `.env.test` configuration and run `npm run start:test`. All operations are simulated.

What if I get connection errors when starting the server?

If `localhost` fails, find your computer’s local IP address (e.g., `192.168.x.x`), update `ANKI_CONNECT_URL` to `http://YOUR_LOCAL_IP:8765`, and ensure AnkiConnect allows connections from that IP.

What tools does Anki MCP Server expose to Claude?

Two tools: `get_leech_cards` (with optional `detailed` and `count` parameters) and `tag_reviewed_cards` (with required `card_ids` and optional `custom_tag_prefix`).