anki-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@anki-mcpAdd the word 'ubiquitous' with definition 'present everywhere' and example 'Smartphones are ubiquitous today.'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Anki MCP 词汇管理器
一个基于 MCP (Model Context Protocol) 的智能 Anki 词汇管理工具,支持自动生成发音、智能搜索和统计分析。
功能特点
智能词汇管理
批量添加单词和个别添加
自动生成单词、释义和例句的发音(OpenAI TTS)
支持标签系统和笔记功能
CSV 格式存储,支持版本控制,防止单词丢失
高级搜索和分析
多维度排序:到期时间、最近复习、难度等
智能搜索:支持单词和释义的模糊匹配
详细统计:复习次数、正确率、熟悉度等
自动化工具
完全自动化的 Anki 卡片创建
智能音频缓存系统
详细的日志记录
工具命令
add-words-batch
添加单词到词汇表并创建 Anki 卡片(支持单个和批量操作)
输入:
words: 单词数组,每个包含:
word: 单词(仅英文)
definition: 释义(仅英文)
example: 例句(可选,仅英文)
notes: 笔记(可选,仅英文)
tags: 标签数组(可选,仅支持字母、数字、连字符和下划线)
list-words
列出 Anki 中的单词,支持多种排序方式:
due: 按到期时间排序(不熟悉的词优先)
recent: 按复习频率排序(最近复习优先)
difficulty: 按正确率排序(最具挑战性优先)
added: 按创建时间排序(最新添加优先)
lapses: 按遗忘次数排序(最常遗忘优先)
search-words
在 Anki 牌组中搜索单词和释义
输入:
query: 搜索关键词
limit: 返回结果数量(1-50,默认20)
安装要求
Node.js (v16+)
Anki
AnkiConnect 插件(插件代码:2055492159)
OpenAI API 密钥
AnkiConnect 插件安装
打开 Anki
点击顶部菜单 Tools(工具) -> Add-ons(插件)
点击 "Get Add-ons..."(获取插件...)按钮
输入插件代码:
2055492159点击 OK 安装
重启 Anki 使插件生效
验证安装:
确保 Anki 正在运行
在浏览器中访问
http://localhost:8765如果看到空白页面或 JSON 响应,说明插件安装成功
快速开始
克隆仓库:
git clone <repository-url> cd anki-mcp安装依赖:
npm install构建项目:
npm run build
MCP 配置
在 Claude Desktop 中配置(编辑 ~/.config/claude-mcp/config.json):
{
"servers": {
"anki-mcp": {
"command": "node",
"args": ["/path-of-project/build/index.js"],
"env": {
"OPENAI_API_KEY": "你的OpenAI API密钥",
"OPENAI_API_BASE": "可选的API基础URL",
"ANKI_DECK_NAME": "你的Anki牌组名称",
"ANKI_MODEL_NAME": "你的卡片模板名称",
"ANKI_CONNECT_URL": "http://localhost:8765"
}
}
}
}环境变量
变量名 | 描述 | 默认值 |
OPENAI_API_KEY | OpenAI API 密钥 | 必需 |
OPENAI_API_BASE | OpenAI API 基础 URL | 可选 |
ANKI_DECK_NAME | Anki 牌组名称 | "Vocabulary" |
ANKI_MODEL_NAME | Anki 模板名称 | "Basic" |
ANKI_CONNECT_URL | AnkiConnect URL |
项目结构
.
├── data/
│ ├── audio/ # 音频文件缓存
│ └── vocabulary.csv # 词汇数据存储
├── logs/ # 日志文件
├── src/
│ └── index.ts # 主程序
└── package.json开发指南
启动开发模式:
npm run dev日志查看:
tail -f logs/anki-mcp-YYYY-MM-DD.log
Anki 模板配置
在使用本工具之前,需要在 Anki 中创建正确的卡片模板。请按照以下步骤配置:
在 Anki 中创建一个新的笔记类型(Tools -> Manage Note Types -> Add)
添加以下字段:
Word(单词)
WordAudio(单词发音)
Definition(释义)
DefinitionAudio(释义发音)
Example(例句)
ExampleAudio(例句发音)
配置卡片模板:
正面模板
<div class="container">
<div class="word">{{Word}}</div>
<div class="audio-wrapper">{{WordAudio}}</div>
</div>背面模板
<div class="container">
<!-- 单词部分 -->
<div class="header">
<div class="word">{{Word}}</div>
<div class="audio-wrapper">{{WordAudio}}</div>
</div>
<!-- 释义部分 -->
<div class="section">
<div class="label">Definition</div>
<div class="content">{{Definition}}</div>
<div class="audio-wrapper">{{DefinitionAudio}}</div>
</div>
<!-- 例句部分 -->
<div class="section">
<div class="label">Example</div>
<div class="content">{{Example}}</div>
<div class="audio-wrapper">{{ExampleAudio}}</div>
</div>
</div>样式表
.card {
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
background-color: #ffffff;
color: #2c3e50;
line-height: 1.6;
}
.container {
padding: 30px;
max-width: 800px;
margin: 0 auto;
}
.header {
text-align: center;
margin-bottom: 40px;
padding-bottom: 30px;
border-bottom: 1px solid #eee;
}
.word {
font-size: 36px;
font-weight: 700;
color: #1a1a1a;
margin-bottom: 10px;
letter-spacing: 0.5px;
}
.section {
margin-bottom: 35px;
padding: 20px;
background-color: #f8f9fa;
border-radius: 12px;
box-shadow: 0 2px 4px rgba(0,0,0,0.05);
}
.label {
font-size: 20px;
font-weight: 600;
color: #666;
margin-bottom: 12px;
text-transform: uppercase;
letter-spacing: 1px;
}
.content {
font-size: 22px;
color: #2c3e50;
line-height: 1.7;
padding: 0 10px;
}
/* 隐藏音频控件 */
.audio-wrapper {
height: 0;
width: 0;
opacity: 0;
overflow: hidden;
position: absolute;
}
/* 响应式设计 */
@media (max-width: 480px) {
.container {
padding: 20px;
}
.word {
font-size: 32px;
}
.content {
font-size: 20px;
}
}
/* 夜间模式支持 */
.nightMode .card {
background-color: #1a1a1a;
color: #ffffff;
}
.nightMode .section {
background-color: #2d2d2d;
}
.nightMode .word {
color: #ffffff;
}
.nightMode .label {
color: #aaaaaa;
}
.nightMode .content {
color: #dddddd;
}在环境变量中设置
ANKI_MODEL_NAME为你创建的模板名称
注意事项
确保 Anki 和 AnkiConnect 插件正在运行
音频文件会自动缓存在
data/audio目录词汇数据保存在
data/vocabulary.csv详细日志保存在
logs目录
屏幕截图



许可证
ISC
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/solidSpoon/anki-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server