AI导哈

Anki连接MCP服务器

一个高质量的模型上下文协议（MCP）服务器，通过Anki-Connect插件为LLMs（如Claude）和Anki之间提供桥梁，实现强类型化的闪卡管理自动化。

  • by TomatoCream
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 TomatoCream/anki-mcp

使用说明

Anki Connect MCP服务器

一个高质量的模型上下文协议（MCP）服务器，在LLM（如Claude）和 Anki 通过 Anki Connect 插件。

项目目标

本项目的主要目标是提供 强类型 对于所有使用Pydantic的Anki Connect输入和输出，确保LLM有一个清晰、经过模式验证的接口与Anki的数据库进行交互。这最大限度地减少了错误，并允许闪存卡管理的复杂自动化。

内置：

  • python 3.12+
  • FastMCP （来自模型上下文协议生态系统）
  • Pydantic v2 用于强打字和验证
  • Typer 和 Rich 用于CLI交互

特性

  • 票据管理：添加、搜索、更新和删除笔记。
  • 卡片检查：查找卡片并获得详细的渲染（HTML问题/答案）。
  • 甲板和模型支撑：列出套牌，创建套牌，并探索笔记类型。
  • 强类型：每个工具都使用Pydantic模型进行请求/响应，使LLM能够完美地理解输入和输出。
  • 证据充分的：专门为LLM消费量身定制的大量文档和字段描述。

先决条件

  1. Anki 必须安装并运行。
  2. Anki Connect 必须在Anki中安装插件（插件代码： 2055492159).
  3. Python 3.12 或更高。
  4. 紫外线 （推荐）用于包装管理。

快速开始

安装

# Clone the repository
git clone https://github.com/your-repo/org-anki.git
cd org-anki/anki-mcp

# Install dependencies and the package
uv pip install -e .

运行服务器

服务器通过以下方式进行通信 stdio 默认情况下，这是MCP的标准。

# From the anki-mcp directory
uv run anki-mcp --url http://localhost:8765

与Claude Desktop集成

要在Claude Desktop中使用此服务器，请将以下内容添加到您的 claude_desktop_config.json （在Linux上，通常在 ~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "anki": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/your/org-anki/anki-mcp",
        "anki-mcp"
      ]
    }
  }
}

替换 /path/to/your/org-anki/ 带有克隆存储库的绝对路径。

可用工具

  • ping：检查与Anki Connect的连接。
  • add_note：使用字段、标签和媒体创建单个注释。
  • add_notes：批量添加多个注释。
  • find_notes：使用Anki的搜索语法搜索笔记。
  • notes_info：获取完整的笔记数据（字段、标签、卡片）。
  • update_note_fields：修改现有注释的字段或标签。
  • delete_notes：从收藏中删除笔记。
  • find_cards：搜索特定卡片。
  • cards_info：获取卡片详细信息（HTML、间隔等）。
  • deck_names：列出所有甲板。
  • create_deck：创建新甲板。
  • model_names：列出所有笔记类型。
  • model_field_names：列出特定笔记类型的字段。

发展

在开发模式下运行服务器 FastMCP检查员 （web调试器）：

uv run fastmcp dev src/anki_mcp/main.py

这将启动一个web界面，您可以在其中手动测试所有工具。

相关 MCP