Anki-MCP 服务器

一个与 Anki 集成的 MCP 服务器，通过 AnkiConnect 插件进行交互。

这是一个基于 TypeScript 的 MCP 服务器，展示了核心 MCP 概念，包括：

• 资源：通过 anki://decks/{id} 和 anki://models/{id} URI 访问 Anki 燕堆和笔记模型
• 工具：用于创建和管理 Anki 笔记
• 集成：与 AnkiConnect API 对接

功能

资源

• 列出并通过 anki://decks/{id} URIs 访问所有 Anki 燕堆
• 列出并通过 anki://models/{id} URIs 访问所有笔记模型
• 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 服务器通过标准输入输出进行通信，调试可能较为困难。我们推荐使用 MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector 将提供一个访问浏览器调试工具的 URL。