genanki-mcp 是一个基于 genanki 和 Model Context Protocol (MCP) 的自动化制卡服务。这个项目提供了一个 streamable_http 的 mcp 工具,可以被任何符合 MCP 规范的客户端调用。用户可以将需要添加到卡组的媒体文件添加到程序的工作目录下,并通过提示词告诉 llm 媒体路径(相对路径),即可将媒体文件添加至卡组内。项目遵循“够用即可”的思路(KISS & YAGNI),仅聚焦在可靠创建牌组、限制媒体路径、防止临时文件堆积等核心需求。功能特点包括:由 agent 制定复杂 CSS 样式,允许嵌入媒体文件;自动生成临时下载链接(默认 600 秒过期),支持外部系统拉取 .apkg;媒体文件路径沙盒校验,避免越界访问与遗漏。项目目录结构包括 anki_tools、server、temp_anki_decks、.envexample、pyproject.toml 和 uv.lock。快速开始步骤包括 git clone 仓库、进入目录、安装依赖、配置环境变量和启动服务。运行环境要求 Python ≥ 3.13,推荐使用 uv 或 pip 管理依赖。使用时,只需使用支持 mcp 的客户端即可,mcp 服务默认监听在 http://127.0.0.1:10099/anki。项目许可证为 MIT 许可。

标签: none

评论已关闭