Genanki MCP

🚀 genanki-mcp

genanki と Model Context Protocol (MCP) を用いて構築された、自動化されたAnkiデッキ生成サービスです。
信頼性の高いデッキ作成、厳格なメディアサンドボックス化、そしてシンプルなワークフローの維持に焦点を当てています。

中文ドキュメント

✨ 主な機能

• 任意のMCP準拠クライアントに接続可能なストリーム対応MCP HTTPツール
• エージェントが豊富な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 に複製し、必要に応じて調整してください。

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ライセンス