genanki-mcp

使用 genanki 和 模型上下文协议 (MCP) 构建的自动 Anki 卡片集生成服务。专注于可靠的卡片集创建、严格的媒体沙箱以及保持工作流程精简——没有更多。

中文文档

特点

• 可流式传输的 MCP HTTP 工具，可插入任何符合 MCP 规范的客户端
• 代理可以制作丰富的 CSS 模板并安全地嵌入媒体资源
• .apkg 文件的临时下载链接（默认过期时间为 600 秒）
• 媒体路径沙箱防止超出范围的文件访问和孤立的资源

项目布局

anki_mcp/
├── anki_tools/           # genanki 实用工具封装
│   └── genanki_tool.py
├── server/               # MCP + HTTP 入口点
│   ├── anki_models.py    # Pydantic 请求/响应模型
│   └── anki_server.py    # FastMCP / Starlette 服务器
├── temp_anki_decks/      # 临时 .apkg 导出
├── .envexample           # 环境变量模板
├── pyproject.toml        # uv / pip 项目定义
└── uv.lock

快速开始

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

要求

• Python ≥ 3.13
• 依赖管理通过 uv（推荐）或 pip

安装依赖

# 使用 uv（推荐）
uv sync

# 或者使用 pip
python -m venv .venv
.venv\Scripts\activate  # PowerShell
pip install -r requirements.txt

配置环境变量

复制 .envexample 到 .env 并根据需要进行调整。

变量	描述	默认值
PORT	Uvicorn/FastMCP 监听端口	10099
SREVERIP	组成下载链接使用的公共 IP/主机	127.0.0.1
TOKEN	保护工具访问的可选承载令牌	（空）

如果省略 TOKEN，服务将跳过身份验证。在生产环境中设置它。

运行服务

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

FastMCP 在 http://0.0.0.0:<PORT>/anki 暴露工具，并在 http://0.0.0.0:<PORT>/downloads 提供临时下载。

使用方法

连接到任何支持 MCP 的客户端。默认情况下，MCP 端点监听在 http://127.0.0.1:10099/anki。

Cherry Studio 示例配置和工作流程：

许可证

MIT 许可证