🚀 Anki MCP 服务器
Anki MCP 服务器是一个基于模型上下文协议（MCP）的服务器，它让大语言模型能够借助 AnkiConnect 与 Anki 翻牌软件进行交互，极大地拓展了 Anki 的使用场景和功能。
🚀 快速开始
在使用 Anki MCP 服务器之前，你需要完成以下先决条件的准备：
- 安装Anki。
- 在 Anki 中安装AnkiConnect插件。
✨ 主要特性
工具
list_decks- 列出所有可用的 Anki 牌组。create_deck- 创建一个新的 Anki 牌组。create_note- 创建新的笔记（基本或删除型）。batch_create_notes- 一次性创建多条笔记。search_notes- 使用 Anki 查询语法搜索笔记。get_note_info- 获取笔记的详细信息。update_note- 更新现有的笔记。delete_note- 删除一条笔记。list_note_types- 列出所有可用的笔记类型。create_note_type- 创建新的笔记类型。get_note_type_info- 获取特定笔记类型的结构信息。
资源
anki://decks/all- 所有可用牌组的完整列表。anki://note-types/all- 所有可用笔记类型的列表。anki://note-types/all-with-schemas- 所有笔记类型的详细结构信息。anki://note-types/{modelName}- 特定笔记类型的详细结构信息。
📦 安装指南
与Claude Desktop一起使用
将服务器添加到claude_desktop_config.json：
{
"mcpServers": {
"anki": {
"command": "npx",
"args": ["--yes","anki-mcp-server"]
}
}
}
Cline的配置
将服务器添加到 VSCode 设置中的cline_mcp_settings.json文件：
{
"mcpServers": {
"anki": {
"command": "npx",
"args": ["--yes","anki-mcp-server"]
}
}
}
💻 使用示例
基础用法
- 创建一个新的牌组：
创建一个名为“编程”的新 Anki 牌组
- 添加一张基本卡片：
在“编程”牌组中创建一张新的卡片，正面为：“JavaScript 中的闭包是什么？”，背面为：“闭包是函数和变量的组合，能够保留其作用域。”
- 添加一张删除型卡片：
在“编程”牌组中创建一条新的删除型卡片，问题为：“JavaScript 中的闭包如何使用？”，答案为：“通过将函数定义在另一个函数内部，并捕获外部函数的变量来实现。”
🔧 技术细节
设置
- 安装依赖：
npm install
- 构建服务器：
npm run build
- 开发时自动重建：
npm run watch
测试
运行测试套件：
npm test
这将执行以下内容的测试：
- 服务器初始化。
- AnkiConnect 通信。
- 笔记操作（创建/读取/更新/删除）。
- 牌组管理。
- 错误处理。
调试
由于 MCP 服务器通过标准输入输出进行通信，我们推荐使用MCP 检查器：
npm run inspector
这将提供一个基于浏览器的界面用于：
- 监控 MCP 消息。
- 测试工具调用。
- 查看服务器日志。
- 调试通信问题。
📄 许可证
项目采用MIT 许可证，具体条款如下：
(此处应包含完整的 MIT 许可证文本)
🤝 贡献指南
- 代码提交时请遵循Contributing.md文件中的规范。
- 提交问题或建议到Issues 页面。