Anki MCP 服务器

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

功能

• 在Anki中创建新牌组
• 向现有牌组添加笔记
• 列出可用的牌组和笔记模型
• 使用Anki的搜索语法查找笔记
• 获取有关笔记模型及其字段的详细信息
• 批量添加多个笔记

前提条件

• Node.js (v14或更高版本)
• 安装了AnkiConnect插件的Anki
• 一个兼容模型上下文协议的客户端（例如支持Anthropic MCP的Claude）

安装

1. 确保已安装带有AnkiConnect插件的Anki

   • 通过工具 > 插件 > 获取插件并输入代码 2055492159 来安装AnkiConnect

2. 克隆此仓库：

   git clone https://github.com/yourusername/anki-mcp-server.git
   cd anki-mcp-server

3. 安装依赖项：

   npm install

4. 构建项目：

   npm run build

使用方法

1. 确保您的计算机上正在运行带有AnkiConnect功能的Anki

2. 启动MCP服务器：

   npm start

3. 将您的MCP客户端（例如Claude）连接到此服务器

可用工具

服务器为MCP客户端提供了以下工具：

• listDecks: 获取Anki中的所有牌组列表
• listModels: 获取Anki中的所有笔记模型/类型列表
• createDeck: 在Anki中创建一个新的牌组
• getModel: 获取特定笔记模型/类型的详细信息
• addNote: 向牌组中添加单个笔记
• addNotes: 一次性添加多个笔记
• searchNotes: 使用Anki的搜索语法查找笔记

示例

创建新牌组

json
{
"name": "createDeck",
"arguments": {
"name": "我的新牌组"
}
}

添加笔记

json
{
"name": "addNote",
"arguments": {
"deckName": "我的新牌组",
"modelName": "基础",
"fields": {
"正面": "法国的首都是什么？",
"背面": "巴黎"
},
"tags": ["地理", "欧洲"]
}
}

搜索笔记

json
{
"name": "searchNotes",
"arguments": {
"query": "deck:我的新牌组 tag:地理"
}
}

配置

服务器配置位于 src/index.ts 中的 config 对象。您可以修改：

• ankiConnectUrl: AnkiConnect API 的 URL (默认: http://localhost:8765)
• apiVersion: AnkiConnect 的 API 版本 (默认: 6)
• defaultDeckName: 如果未指定，则使用的默认牌组名称 (默认: Default)

故障排除

1. 无法连接到Anki

   • 确保Anki正在运行
   • 检查AnkiConnect插件是否已安装且正常工作
   • 确认AnkiConnect URL正确（默认: http://localhost:8765）

2. AnkiConnect权限问题

   • 当服务器尝试添加卡片时，AnkiConnect可能会提示权限请求。请在Anki中查找弹出窗口。

许可证

MIT许可证