# Anki上下文协议服务器
## 基本信息
- Slug: `nailuogg-anki-mcp-server`
- Source: modelscope
- Publisher: @nailuoGG/anki-mcp-server
- Categories: education-and-learning-tools / note-taking / knowledge-and-memory
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@nailuoGG/anki-mcp-server
## 简介
一种模型上下文协议服务器，使大型语言模型（LLMs）能够通过AnkiConnect与Anki闪卡软件交互，从而实现对闪卡、卡组和笔记类型的创建与管理。
## 安装提示

```bash
### Cline 的配置 在 VSCode 的设置文件 cline_mcp_settings.json 中添加服务器至 Cline MCP 设置：
```

## MCP Server 详情

# Anki MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过 AnkiConnect 使 LLM 能够与 Anki 闪卡软件进行交互。

![Anki 图标](./assets/icon.png)

## 功能

### 工具
- `list_decks` - 列出所有可用的 Anki 卡组
- `create_deck` - 创建一个新的 Anki 卡组
- `create_note` - 创建一个新的笔记（基础或Cloze）
- `batch_create_notes` - 一次性创建多个笔记
- `search_notes` - 使用 Anki 查询语法搜索笔记
- `get_note_info` - 获取关于某个笔记的详细信息
- `update_note` - 更新现有笔记
- `delete_note` - 删除笔记
- `list_note_types` - 列出所有可用的笔记类型
- `create_note_type` - 创建新的笔记类型
- `get_note_type_info` - 获取特定笔记类型的详细结构

### 资源
- `anki://decks/all` - 所有可用卡组的完整列表
- `anki://note-types/all` - 所有可用笔记类型的列表
- `anki://note-types/all-with-schemas` - 所有笔记类型的详细结构信息
- `anki://note-types/{modelName}` - 特定笔记类型的详细结构信息

## 前提条件

1. 系统上安装了 [Anki](https://apps.ankiweb.net/)
2. 在 Anki 中安装了 [AnkiConnect](https://ankiweb.net/shared/info/2055492159) 插件

## 配置

### 与 Claude Desktop 一起使用

将服务器添加到您的 claude_desktop_config.json 文件中：

```json
{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes","anki-mcp-server"]
    }
  }
}
```


### Cline 的配置

在 VSCode 的设置文件 cline_mcp_settings.json 中添加服务器至 Cline MCP 设置：

```json
{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes","anki-mcp-server"]
    }
  }
}
```


## 开发

### 设置

1. 安装依赖项：
```bash
npm install
```


2. 构建服务器：
```bash
npm run build
```


3. 开发时自动重建：
```bash
npm run watch
```


### 测试

运行测试套件：
```bash
npm test
```


这会执行以下方面的测试：
- 服务器初始化
- 与 AnkiConnect 的通信
- 笔记操作（创建/读取/更新/删除）
- 卡组管理
- 错误处理

### 调试

由于 MCP 服务器通过 stdio 进行通信，我们建议使用 [MCP Inspector](https://github.com/modelcontextprotocol/inspector)：

```bash
npm run inspector
```


它提供了基于浏览器的界面来：
- 监控 MCP 消息
- 测试工具调用
- 查看服务器日志
- 调试通信问题

## 使用示例

1. 创建一个新的卡组：
```
Create a new Anki deck called "Programming"
```


2. 添加一张基础卡片：
```
Create an Anki card in the "Programming" deck with:
Front: What is a closure in JavaScript?
Back: A closure is the combination of a function and the lexical environment within which that function was declared.
```


3. 添加一张Cloze删除卡片：
```
Create a cloze card in the "Programming" deck with:
Text: In JavaScript, {{c1::const}} declares a block-scoped variable that cannot be {{c2::reassigned}}.
```


## 贡献

1. 叉分仓库
2. 创建你的功能分支
3. 运行测试：`npm test`
4. 提交拉取请求

## 致谢

图标来自 [macOS Icons](https://macosicons.com/#/?icon=mWDBpVXqbc)

## 许可证

MIT 许可证 - 详情请参阅 LICENSE 文件