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:

License

MIT License