genanki-mcp

Automated Anki deck generation service built with genanki and the Model Context Protocol (MCP).
Focuses on dependable deck creation, strict media sandboxing, and keeping the workflow lean—nothing more.

中文文档

Highlights

Streamable MCP HTTP tool that plugs into any MCP-compliant client
Agents can craft rich CSS templates and embed media assets safely
Temporary download links (default expiry 600 seconds) for .apkg retrieval
Media path sandbox prevents out-of-scope file access and orphaned assets

Project Layout

anki_mcp/ ├── anki_tools/ # genanki utility wrapper │ └── genanki_tool.py ├── server/ # MCP + HTTP entrypoints │ ├── anki_models.py # Pydantic request/response models │ └── anki_server.py # FastMCP / Starlette server ├── temp_anki_decks/ # Temporary .apkg exports ├── .envexample # Environment variable template ├── pyproject.toml # uv / pip project definition └── uv.lock

Quick Start

git clone https://github.com/Epiphany-0312/genanki-mcp.git cd genanki-mcp

Requirements

Python ≥ 3.13
Dependency management via uv (recommended) or pip

Install Dependencies

# With uv (recommended) uv sync # Or with pip python -m venv .venv .venv\Scripts\activate # PowerShell pip install -r requirements.txt

Configure Environment Variables

Duplicate .envexample to .env and adjust as needed.

Variable	Description	Default
`PORT`	Uvicorn/FastMCP listening port	`10099`
`SREVERIP`	Public IP/host used to compose download links	`127.0.0.1`
`TOKEN`	Optional bearer token protecting tool access	(empty)

If TOKEN is omitted, the service skips authentication. Set it in production environments.

Run the Service

uv run python -m server.anki_server # or python -m server.anki_server

FastMCP exposes the tool at http://0.0.0.0:<PORT>/anki and temporary downloads at http://0.0.0.0:<PORT>/downloads.

Usage

Connect with any MCP-capable client. By default the MCP endpoint listens on http://127.0.0.1:10099/anki.

Cherry Studio example configuration and workflow:

Cherry Studio configuration

Cherry Studio tool list

Cherry Studio deck preview

License

MIT License

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables automated generation of Anki flashcard decks with rich CSS templates and media assets. Provides secure deck creation with sandboxed media handling and temporary download links for .apkg files.

Genanki MCP Server