内容
# Anki-MCP
一个用于通过 AnkiConnect API 与 Anki 闪卡应用程序交互的 MCP(模型控制协议)服务器。
## 概述
Anki-MCP 为您的 LLM(大语言模型)与 Anki 之间提供了一个桥梁。该项目实现了 Anki-Connect API(https://git.sr.ht/~foosoft/anki-connect)作为 MCP 服务器。
## 先决条件
- 在您的系统上安装 [Anki](https://apps.ankiweb.net/)
- 在 Anki 中安装 [AnkiConnect 插件](https://ankiweb.net/shared/info/2055492159)
- Node.js(推荐使用 v14 或更高版本)
## 安装
1. 克隆此仓库
2. 使用 `npm install` 安装依赖
3. 配置您的 MCP 设置(见下文),以包含 Anki-MCP 服务器
## 配置
根据您的 MCP 主机,将以下内容添加到您的 `mcp_settings.json` 文件中:
```json
"anki-connect": {
"command": "node",
"args": [
"/path/to/anki-mcp/index.js"
],
"disabled": false,
"autoApprove": []
}
```
将 `/path/to/anki-mcp/index.js` 替换为您安装的实际路径。
## 使用
**重要**:Anki 必须在 AnkiConnect 插件激活的情况下运行,以使此 MCP 服务器正常工作。
配置完成后,您可以使用 Anki-MCP 服务器来:
- 创建和更新闪卡
- 管理卡组
- 查询卡片信息
- 执行所有来自 [AnkiConnect 插件](https://ankiweb.net/shared/info/2055492159) 的 Anki 操作
## 可用工具
该服务器提供了支持 AnkiConnect 的所有操作的工具,包括:
- 卡片操作(getEaseFactors、suspend、unsuspend 等)
- 卡组操作(deckNames、createDeck、changeDeck 等)
- 笔记操作(addNote、updateNote、findNotes 等)
- 媒体操作(storeMediaFile、retrieveMediaFile 等)
- 以及更多
## 许可证
[GPL-3.0](LICENSE)
## 致谢
- AnkiConnect(https://git.sr.ht/~foosoft/anki-connect)提供了使这一切成为可能的 API
- Anki 团队为他们令人难以置信的闪卡应用程序