anki-mcp-server

阅读其他语言版本：英文，韩语

这是一个模型上下文协议（MCP）服务器，连接Claude和Anki，使您能够轻松地使用自然语言创建闪卡。

简介

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 并从顶部菜单选择 工具 > 插件 > 获取插件
   • 输入代码 2055492159 并点击 '确定'
   • 重启 Anki

2. 安装 anki-mcp-server

# 克隆仓库
git clone https://github.com/dhkim0124/anki-mcp-server.git
cd anki-mcp-server

# 创建并激活虚拟环境（可选）
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装所需包
pip install -r requirements.txt

配置

Claude Desktop 设置

修改 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. 向配置文件添加以下内容：

{
  "mcpServers": {
    "anki-mcp": {
      "command": "python",
      "args": ["path/anki_server.py"],
      "env": {}
    }
  }
}

将 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 上 fork 该仓库并提交拉取请求。我们欢迎以下领域的贡献：

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

许可证

此项目根据 MIT 许可证分发。详情见 LICENSE 文件。

联系方式

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