MCP 服务器

anki-mcp

Enables intelligent Anki vocabulary management with automatic TTS audio generation, batch card creation, and advanced search and analysis.

README

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	"http://localhost:8765"

项目结构

.
├── 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;
}