anki-mcp MCP Server

anki-mcp MCP 服务

通过 AnkiConnect 插件与 Anki 集成的服务

这是一个基于 TypeScript 的 MCP 服务，通过 AnkiConnect 插件与 Anki 集成。它通过提供以下功能展示了 MCP 的核心概念：

• 使用 URI 表示 Anki 牌组和笔记模板的资源
• 用于创建和管理 Anki 笔记的工具
• 与 AnkiConnect API 集成

功能

资源

• 通过 anki://decks/{id} URI 列出和访问 Anki 牌组
• 通过 anki://models/{id} URI 列出和访问笔记模板
• Anki 对象的 JSON 表示

工具

• listDecks - 获取所有牌组的名称
• listModels - 获取所有笔记模板的名称
• getModel - 获取指定笔记模板的详细信息
• addNote - 创建单条笔记
  • 指定牌组名称、模板名称、字段和标签
• addNotes - 批量创建多条笔记
  • 使用指定参数创建多条笔记

开发

安装依赖项：

npm install

构建服务：

npm run build

在开发模式下自动重新构建：

npm run watch

安装

要与 Claude Desktop 配合使用，请添加服务配置：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "anki-mcp": {
      "command": "node",
      "args": ["d:\\anki-mcp-server\\build\\index.js"]
    }
  }
}

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它可通过包脚本运行：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。