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

安装Anki 。
安装 AnkiConnect 插件：
- 运行 Anki 并从顶部菜单中选择Tools > Add-ons > Get Add-ons
- 输入代码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 桌面设置

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

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
在配置文件中添加以下内容：

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

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

如何使用

运行 Anki 应用程序并使其在后台保持运行。
启动 Claude Desktop。
您可以向 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 问题联系我们。

Anki MCP Server

Integrations