🚀 Anki MCP 服务器

Anki MCP 服务器是专门为 Claude Desktop 设计的，它遵循模型上下文协议（MCP），借助 AnkiConnect 与 Anki 建立连接，能够检索带有“leech”标签的卡片，为卡片管理和分析提供便利。

🚀 快速开始

Anki MCP 服务器是一个为 Claude Desktop 设计的工具，它能通过 AnkiConnect 连接 Anki，检索特定卡片。在使用前，请确保满足先决条件，并按照安装步骤进行操作。

✨ 主要特性

• Anki 连接：借助 AnkiConnect API 与 Anki 建立稳定连接。
• 卡片检索：精准检索带有“leech”标签的卡片。
• 审查标签添加：为卡片添加带有日期戳记的审查标签。
• 数据提供：提供全面的卡片数据，便于 Claude 进行深入分析。
• 兼容性：可与 Claude Desktop 完美配合使用。

📦 安装指南

先决条件

• 已安装并运行 Anki，可从 这里 获取。
• Anki 中已安装 AnkiConnect 插件，插件信息。
• 安装 Node.js 和 npm。

安装步骤

1. 克隆代码仓库：

   git clone <repository-url>
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

📚 详细文档

配置说明

通过环境变量配置参数：

如何找到本地 IP 地址

1. 打开 Anki，进入“工具”菜单。
2. 选择“设置”。
3. 在“网络”选项卡下查看“AnkiConnect 监听地址”。

测试模式

为了在不修改实际 Anki 数据的情况下进行测试，请执行以下操作：

1. 设置 ANKI_MOCK_MODE=true 或使用 .env.test 文件。
2. 运行服务器：

   npm run start:test
   

工具使用说明

获取 Leeched 卡片

通过指定查询参数获取卡片列表。

标记已审查卡片

格式为 見直し::YYYYMMDD（可自定义前缀）。 示例：

我已审阅这些卡片，请标记它们：[1234567890, 1234567891]

故障排除

• “无法连接到 Anki” - 确保 Anki 正在运行且 AnkiConnect 已正确安装。
• “未找到任何 Leeched 卡片” - 您的 Anki 中没有标记为“leech”的卡片。
• localhost 连接问题：
  1. 找到本地 IP 地址。
  2. 更新 .env 文件，设置 ANKI_CONNECT_URL=http://YOUR_LOCAL_IP:8765。
  3. 确保 AnkiConnect 允许来自该 IP 的连接。
  4. 修改后重启 MCP 服务器。

开发模式

使用热重载运行服务器：

npm run dev

或在测试模式下开发：

npm run dev:test

📄 许可证

本项目采用 MIT 许可证。