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
.apkgretrieval - 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
Metadata
Release files for iflow-mcp_epiphany-0312-anki-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_epiphany_0312_anki_mcp-0.1.0.tar.gz | 10.5 kB | Without provenance | Details for iflow_mcp_epiphany_0312_anki_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_epiphany_0312_anki_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_epiphany_0312_anki_mcp-0.1.0-py3-none-any.whl |
Total release size: 22.3 kB
Release files / iflow_mcp_epiphany_0312_anki_mcp-0.1.0.tar.gz
| Download URL | iflow_mcp_epiphany_0312_anki_mcp-0.1.0.tar.gz |
|---|---|
| Size | 10.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0d9a723ad950bb872a98335b549820b7be1c97be9cd9dc75f02225be6ac32b3d
|
|
BLAKE2b-256 checksum How to use checksums |
598a0c9ff81a647539ba2078e8e3a468e3c60afbb1998af5306fbcc3e3e37546
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_epiphany_0312_anki_mcp-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_epiphany_0312_anki_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 11.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
db655e1508e796a1b925e013aeb0b60ee7cd9a059dfcc332f39e46aa0e7a426a
|
|
BLAKE2b-256 checksum How to use checksums |
d04923653643aa32b5dba03e7375355e1b3086f8aaf5ec6289a3f62dc334bb39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_epiphany-0312-anki-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.