🚀 Anki MCP 服务器
Anki MCP 服务器是专门为 Claude Desktop 设计的，它遵循模型上下文协议（MCP），借助 AnkiConnect 与 Anki 建立连接，能够检索带有“leech”标签的卡片，为卡片管理和分析提供便利。
🚀 快速开始
Anki MCP 服务器是一个为 Claude Desktop 设计的工具，它能通过 AnkiConnect 连接 Anki，检索特定卡片。在使用前，请确保满足先决条件，并按照安装步骤进行操作。
✨ 主要特性
- Anki 连接：借助 AnkiConnect API 与 Anki 建立稳定连接。
- 卡片检索：精准检索带有“leech”标签的卡片。
- 审查标签添加：为卡片添加带有日期戳记的审查标签。
- 数据提供：提供全面的卡片数据，便于 Claude 进行深入分析。
- 兼容性：可与 Claude Desktop 完美配合使用。
📦 安装指南
先决条件
安装步骤
- 克隆代码仓库：
git clone - 安装依赖项：
npm install - 构建项目：
npm run build
📚 详细文档
配置说明
通过环境变量配置参数：
| 属性 | 详情 |
|---|---|
ANKI_CONNECT_URL |
连接 Anki 的 URL，默认值为 http://localhost:8765 |
ANKI_MOCK_MODE |
启用 mock 模式（布尔值），默认值为 false |
REVIEW_TAG_PREFIX |
审查标签的自定义前缀，默认值为 "見直し" |
如何找到本地 IP 地址
- 打开 Anki，进入“工具”菜单。
- 选择“设置”。
- 在“网络”选项卡下查看“AnkiConnect 监听地址”。
测试模式
为了在不修改实际 Anki 数据的情况下进行测试，请执行以下操作：
- 设置
ANKI_MOCK_MODE=true或使用.env.test文件。 - 运行服务器：
npm run start:test
工具使用说明
获取 Leeched 卡片
通过指定查询参数获取卡片列表。
标记已审查卡片
格式为 見直し::YYYYMMDD（可自定义前缀）。
示例：
我已审阅这些卡片，请标记它们：[1234567890, 1234567891]
故障排除
- “无法连接到 Anki” - 确保 Anki 正在运行且 AnkiConnect 已正确安装。
- “未找到任何 Leeched 卡片” - 您的 Anki 中没有标记为“leech”的卡片。
- localhost 连接问题：
- 找到本地 IP 地址。
- 更新
.env文件，设置ANKI_CONNECT_URL=http://YOUR_LOCAL_IP:8765。 - 确保 AnkiConnect 允许来自该 IP 的连接。
- 修改后重启 MCP 服务器。
开发模式
使用热重载运行服务器：
npm run dev
或在测试模式下开发：
npm run dev:test
📄 许可证
本项目采用 MIT 许可证。