内容
# Anki MCP 服务器
Anki MCP 服务器的实现,连接本地运行的 Anki,提供卡片复习和创建功能。
该服务器设计用于与 [Anki 桌面应用程序](https://apps.ankiweb.net/) 和 [Anki-Connect](https://foosoft.net/projects/anki-connect/) 插件配合使用。
在使用前,请确保已安装该插件。
## 资源
- **anki://search/deckcurrent**
- 返回当前牌堆的所有卡片
- 等同于 Anki 中的 `deck:current`
- **anki://search/isdue**
- 返回正在复习和学习等待学习的卡片
- 等同于 Anki 中的 `is:due`
- **anki://search/isnew**
- 返回所有未见过的卡片
- 等同于 Anki 中的 `is:new`
## 工具
- **更新卡片**
- 将给定卡片 ID 的卡片标记为已回答,并给予它们 1(Again)至 4(Easy)之间的 Ease 分数
- 输入:
- `答案`(数组):包含 `卡片ID`(数字)和 `Ease`(数字)字段的对象数组
- **添加卡片**
- 在默认 Anki 牌堆中创建新的卡片
- 输入:
- `正面`(字符串):卡片正面
- `背面`(字符串):卡片背面
- **获取到期卡片**
- 返回指定数量的当前到期复习卡片
- 输入:
- `数量`(数字):卡片数量
- **获取新卡片**
- 返回指定数量的新卡片
- 输入:
- `数量`(数字):卡片数量
## 开发
安装依赖:
```bash
npm install
```
构建服务器:
```bash
npm run build
```
开发并自动重建:
```bash
npm run watch
```
## 配置
要与 Claude Desktop 一起使用,请添加服务器配置:
在 MacOS 上:`~/Library/Application Support/Claude/claude_desktop_config.json`
在 Windows 上: `%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"anki-mcp-server": {
"command": "/path/to/anki-mcp-server/build/index.js"
}
}
}
```
### 调试
由于 MCP 服务器通过 stdio 进行通信,调试可能具有挑战性。我们建议使用 [MCP Inspector](https://github.com/modelcontextprotocol/inspector),它作为包脚本提供:
```bash
npm run inspector
```
Inspector 将提供一个 URL,以便在浏览器中访问调试工具。