anki-mcp-server

阅读其他语言版本: English, 한국어

一个 Model Context Protocol (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

# Clone the repository
git clone https://github.com/dhkim0124/anki-mcp-server.git
cd anki-mcp-server

# Create and activate a virtual environment (optional)
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install required packages
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 服务器。

扩展与贡献

如果您希望为项目做贡献，请 fork GitHub 仓库并提交 pull request。我们欢迎以下方面的贡献：

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

许可证

本项目遵循 MIT 许可证发布。详情请参见 LICENSE 文件。

联系方式

对于任何问题或疑问，请通过 GitHub issues 联系我们。