Genanki MCP

🚀 genanki - MCP

本項目是一個自動化的Anki牌組生成服務，它基於 genanki 和 模型上下文協議（MCP） 構建。專注於可靠的牌組創建、嚴格的媒體沙盒機制，並保持簡潔的工作流程，無多餘冗餘。

中文文檔

✨ 主要特性

• 可流式傳輸的MCP HTTP工具，可接入任何符合MCP標準的客戶端。
• 代理能夠創建豐富的CSS模板，並安全地嵌入媒體資源。
• 提供臨時下載鏈接（默認有效期600秒）用於獲取 .apkg 文件。
• 媒體路徑沙盒機制可防止越界文件訪問和孤立資源的產生。

📦 項目結構

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，並根據需要進行調整。

如果省略 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許可證。