Anki MCP 服务器

一个模型上下文协议（MCP）服务器，使大语言模型能够通过AnkiConnect与Anki翻牌软件交互。

功能

工具

• list_decks - 列出所有可用的Anki牌组
• create_deck - 创建一个新的Anki牌组
• create_note - 创建新的笔记（基本或删除型）
• batch_create_notes - 一次性创建多条笔记
• search_notes - 使用Anki查询语法搜索笔记
• get_note_info - 获取笔记的详细信息
• update_note - 更新现有的笔记
• delete_note - 删除一条笔记
• list_note_types - 列出所有可用的笔记类型
• create_note_type - 创建新的笔记类型
• get_note_type_info - 获取特定笔记类型的结构信息

资源

• anki://decks/all - 所有可用牌组的完整列表
• anki://note-types/all - 所有可用笔记类型的列表
• anki://note-types/all-with-schemas - 所有笔记类型的详细结构信息
• anki://note-types/{modelName} - 特定笔记类型的详细结构信息

先决条件

1. 安装了Anki
2. 在Anki中安装了AnkiConnect插件

配置

与Claude Desktop一起使用

将服务器添加到claude_desktop_config.json：

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes","anki-mcp-server"]
    }
  }
}

Cline的配置

将服务器添加到VSCode设置中的cline_mcp_settings.json文件：

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes","anki-mcp-server"]
    }
  }
}

开发

设置

1. 安装依赖：

npm install

2. 构建服务器：

npm run build

3. 开发时自动重建：

npm run watch

测试

运行测试套件：

npm test

这将执行以下内容的测试：

• 服务器初始化
• AnkiConnect通信
• 笔记操作（创建/读取/更新/删除）
• 牌组管理
• 错误处理

调试

由于MCP服务器通过标准输入输出进行通信，我们推荐使用MCP检查器：

npm run inspector

这将提供一个基于浏览器的界面用于：

• 监控MCP消息
• 测试工具调用
• 查看服务器日志
• 调试通信问题

示例使用

1. 创建一个新的牌组：

创建一个名为“编程”的新Anki牌组

2. 添加一张基本卡片：

在“编程”牌组中创建一张新的卡片，正面为：“JavaScript中的闭包是什么？”，背面为：“闭包是函数和变量的组合，能够保留其作用域。”

3. 添加一张删除型卡片：

在“编程”牌组中创建一条新的删除型卡片，问题为：“JavaScript中的闭包如何使用？”，答案为：“通过将函数定义在另一个函数内部，并捕获外部函数的变量来实现。”

贡献指南

• 代码提交时请遵循Contributing.md文件中的规范。
• 提交问题或建议到Issues页面。

许可证

项目采用MIT许可证，具体条款如下：

(此处应包含完整的MIT许可证文本)