Anki MCP Server

anki-mcp-服务器

以其他语言阅读：英语、 한국어

连接 Claude 和 Anki 的模型上下文协议 (MCP) 服务器，允许您使用自然语言轻松创建抽认卡。

介绍

anki-mcp-server 充当 Claude 和 Anki 应用之间的桥梁，实现两者之间的通信。这允许你向 Claude 发出自然语言命令来创建和管理 Anki 抽认卡。例如，如果你请求“在我的日语卡片组中添加一张简单的日语词汇卡”，Claude 会自动创建一张合适的卡片。

要求

• Python 3.8 或更高版本
• Anki 2.1.x 或更高版本
• AnkiConnect 插件
• Claude Desktop（或可以访问 Claude API 的环境）

安装

1. 设置 Anki 和 AnkiConnect

1. 安装Anki 。
2. 安装 AnkiConnect 插件：
   • 运行 Anki 并从顶部菜单中选择Tools > Add-ons > Get Add-ons
   • 输入代码2055492159并点击“确定”
   • 重启 Anki

2. 安装 anki-mcp-server

配置

Claude 桌面设置

修改Claude Desktop配置文件，注册MCP服务器：

1. Claude Desktop配置文件位置：
   • Windows： %APPDATA%\Claude\claude_desktop_config.json
   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux： ~/.config/Claude/claude_desktop_config.json
2. 在配置文件中添加以下内容：

将path/anki_server.py替换为 anki_server.py 文件的绝对路径。

如何使用

1. 运行 Anki 应用程序并使其在后台保持运行。
2. 启动 Claude Desktop。
3. 您可以向 Claude 发出自然语言命令，例如：

示例命令

• “在我的日语卡片组中添加一张简单的日语词汇卡”
• “创建一张卡片，包含英文单词‘perseverance’的含义和例句”
• “将今天学到的编程概念总结成一张卡片”
• “制作5张历史时间线卡片”

Claude 将解释这些请求并通过 MCP 服务器在 Anki 中创建适当的卡片。

主要特点

卡片创建功能

• 基本问答格式卡片创建
• 语言学习卡片制作（单词、含义、例句）
• 自动添加标签
• 将卡牌添加到多个卡组

甲板管理功能

• 查看可用卡组列表
• 创建新卡牌
• 在特定牌组中搜索卡牌

故障排除

连接问题

• 检查 Anki 是否正在运行：MCP 服务器需要 Anki 运行才能与其通信。
• 验证 AnkiConnect ：确保 AnkiConnect 已正确安装。在浏览器中访问http://localhost:8765确认是否显示“AnkiConnect v.6”消息。
• 防火墙设置：Windows 用户可能需要允许 Anki 防火墙访问。

MCP 服务器问题

• 检查日志：如果出现问题，请检查服务器日志中的错误消息。
• 重新启动：如果问题仍然存在，请尝试重新启动 Anki、Claude Desktop 和 MCP 服务器。

扩展和贡献

如果您想为该项目做出贡献，请分叉 GitHub 代码库并提交拉取请求。我们欢迎您参与以下领域的贡献：

• 支持新卡类型
• 改进的语言支持
• 界面改进
• 文档改进

执照

本项目遵循 MIT 许可证。详情请参阅许可证文件。

接触

如有问题或疑问，请通过 GitHub 问题联系我们。