# https://github.com/ankimcp/anki-mcp-server Project Manual Generated on: 2026-05-22 15:39:48 UTC ## Table of Contents - [Repository Overview](#overview) - [Entrypoints and Runtime Surface](#entrypoints) - [Architecture Evidence Map](#architecture) - [Operations and Verification Boundaries](#operations) ## Repository Overview ### Related Pages Related topics: [Entrypoints and Runtime Surface](#entrypoints), [Architecture Evidence Map](#architecture), [Operations and Verification Boundaries](#operations)
Relevant source files The following source files were used to generate this page: - [README.md](https://github.com/ankimcp/anki-mcp-server/blob/main/README.md) - [package.json](https://github.com/ankimcp/anki-mcp-server/blob/main/package.json) - [.docker/docker-compose.yml](https://github.com/ankimcp/anki-mcp-server/blob/main/.docker/docker-compose.yml) - [docs/README.md](https://github.com/ankimcp/anki-mcp-server/blob/main/docs/README.md) - [src/anki-config.service.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/anki-config.service.ts) - [src/app.module.spec.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/app.module.spec.ts) - [src/app.module.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/app.module.ts) - [src/bootstrap.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/bootstrap.ts) - [src/cli.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/cli.ts) - [src/main-http.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/main-http.ts) - [src/main-stdio.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/main-stdio.ts) - [src/mcp/mcp-icons.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/mcp/mcp-icons.ts)
# Repository Overview This page is generated from repository evidence because the Human Wiki provider was unavailable. It intentionally limits itself to README and file-tree facts. ## README Evidence # Anki MCP Server > **⚠️ IMPORTANT: Project Renamed (v0.8.2+)** > > This project has been renamed and moved: > - **Package**: `anki-mcp-http` → `@ankimcp/anki-mcp-server` > - **Commands**: `anki-mcp-http` → `ankimcp` or `anki-mcp-server` > - **Repository**: `anki-mcp/anki-mcp-desktop` → `ankimcp/anki-mcp-server` > > The old `anki-mcp-http` package continues to be published for backward compatibility but is deprecated. Please migrate to the new package. > > **[Read more about this change →](https://ankimcp.ai/blog/organization-and-naming-update/)** [![Tests](https://github.com/ankimcp/anki-mcp-server/actions/workflows/test.yml/badge.svg)](https://github.com/ankimcp/anki-mcp-server/actions/workflows/test.yml) [![npm version](https://badge.fury.io/js/@ankimcp%2Fanki-mcp-server.svg)](https://www.npmjs.com/package/@ankimcp/anki-mcp-server)
Anki + MCP Integration

Seamlessly integrate Anki with AI assistants through the Model Context Protocol

**Beta** - This project is in active development. APIs and features may change. A Model Context Protocol (MCP) server that enables AI assistants to interact with Anki, the spaced repetition flashcard application. Transform your Anki experience with natural language interaction - like having a private tutor. The AI assistant doesn't just present questions and answers; it can explain concepts, make the learning process more engaging and human-like, provide context, and adapt to your learning style. It can create and edit notes on the fly, turning your study sessions into dynamic conversations. More features coming soon! ## Examples and Tutorials For comprehensive guides, real-world examples, and step-by-step tutorials on using this MCP server with Claude Desktop, visit: **[ankimcp.ai](https://ankimcp.ai)** - Complete documentation with practical examples and use cases See [`docs/`](./docs/README.md) for supplementary documentation, including the [reviewer setup guide](./docs/reviewer-setup.md) and the sample Anki deck. ## Example Use Cases Three representative prompts showing the tool flows this server enables: 1. **"Help me review my Spanish deck."** — The assistant syncs with AnkiWeb (`sync`), fetches due cards (`get_ [excerpt truncated] ## Selected Source Inventory - `README.md` - `package.json` - `.docker/docker-compose.yml` - `docs/README.md` - `src/anki-config.service.ts` - `src/app.module.spec.ts` - `src/app.module.ts` - `src/bootstrap.ts` - `src/cli.ts` - `src/main-http.ts` - `src/main-stdio.ts` - `src/mcp/mcp-icons.ts` | File | Evidence role | Size | |---|---|---| | `README.md` | README/product and usage evidence | 33833 bytes | | `package.json` | package/runtime metadata | 6695 bytes | | `.docker/docker-compose.yml` | repository evidence | 462 bytes | | `docs/README.md` | documentation evidence | 575 bytes | | `src/anki-config.service.ts` | implementation surface | 1281 bytes | | `src/app.module.spec.ts` | implementation surface | 8010 bytes | | `src/app.module.ts` | implementation surface | 3152 bytes | | `src/bootstrap.ts` | implementation surface | 1392 bytes | | `src/cli.ts` | implementation surface | 5098 bytes | | `src/main-http.ts` | implementation surface | 1911 bytes | | `src/main-stdio.ts` | implementation surface | 1773 bytes | | `src/mcp/mcp-icons.ts` | implementation surface | 603 bytes | Source: `[README.md:1-120]()` --- ## Entrypoints and Runtime Surface ### Related Pages Related topics: [Repository Overview](#overview), [Architecture Evidence Map](#architecture), [Operations and Verification Boundaries](#operations)
Relevant source files The following source files were used to generate this page: - [README.md](https://github.com/ankimcp/anki-mcp-server/blob/main/README.md) - [package.json](https://github.com/ankimcp/anki-mcp-server/blob/main/package.json) - [.docker/docker-compose.yml](https://github.com/ankimcp/anki-mcp-server/blob/main/.docker/docker-compose.yml) - [docs/README.md](https://github.com/ankimcp/anki-mcp-server/blob/main/docs/README.md) - [src/anki-config.service.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/anki-config.service.ts) - [src/app.module.spec.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/app.module.spec.ts) - [src/app.module.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/app.module.ts) - [src/bootstrap.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/bootstrap.ts) - [src/cli.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/cli.ts) - [src/main-http.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/main-http.ts) - [src/main-stdio.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/main-stdio.ts) - [src/mcp/mcp-icons.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/mcp/mcp-icons.ts)
# Entrypoints and Runtime Surface The files below are the highest-signal candidates for how the project is installed, started, configured, or embedded. Treat this as an evidence map, not an inferred API contract. | File | Evidence role | Size | |---|---|---| | `README.md` | README/product and usage evidence | 33833 bytes | | `package.json` | package/runtime metadata | 6695 bytes | | `.docker/docker-compose.yml` | repository evidence | 462 bytes | | `docs/README.md` | documentation evidence | 575 bytes | | `src/anki-config.service.ts` | implementation surface | 1281 bytes | | `src/app.module.spec.ts` | implementation surface | 8010 bytes | | `src/app.module.ts` | implementation surface | 3152 bytes | | `src/bootstrap.ts` | implementation surface | 1392 bytes | | `src/cli.ts` | implementation surface | 5098 bytes | | `src/main-http.ts` | implementation surface | 1911 bytes | | `src/main-stdio.ts` | implementation surface | 1773 bytes | | `src/mcp/mcp-icons.ts` | implementation surface | 603 bytes | Source: `[README.md:1-120](https://github.com/ankimcp/anki-mcp-server/blob/main/README.md)` --- ## Architecture Evidence Map ### Related Pages Related topics: [Repository Overview](#overview), [Entrypoints and Runtime Surface](#entrypoints), [Operations and Verification Boundaries](#operations)
Relevant source files The following source files were used to generate this page: - [README.md](https://github.com/ankimcp/anki-mcp-server/blob/main/README.md) - [package.json](https://github.com/ankimcp/anki-mcp-server/blob/main/package.json) - [.docker/docker-compose.yml](https://github.com/ankimcp/anki-mcp-server/blob/main/.docker/docker-compose.yml) - [docs/README.md](https://github.com/ankimcp/anki-mcp-server/blob/main/docs/README.md) - [src/anki-config.service.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/anki-config.service.ts) - [src/app.module.spec.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/app.module.spec.ts) - [src/app.module.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/app.module.ts) - [src/bootstrap.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/bootstrap.ts) - [src/cli.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/cli.ts) - [src/main-http.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/main-http.ts) - [src/main-stdio.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/main-stdio.ts) - [src/mcp/mcp-icons.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/mcp/mcp-icons.ts)
# Architecture Evidence Map This section maps source paths into likely architectural areas based on repository layout only. Claims that require execution are intentionally not made here. - `.`: `README.md`, `package.json` - `.docker`: `.docker/docker-compose.yml` - `docs`: `docs/README.md` - `src`: `src/anki-config.service.ts`, `src/app.module.spec.ts`, `src/app.module.ts`, `src/bootstrap.ts`, `src/cli.ts`, `src/main-http.ts` Source: `[package.json:1-120](https://github.com/ankimcp/anki-mcp-server/blob/main/package.json)` --- ## Operations and Verification Boundaries ### Related Pages Related topics: [Repository Overview](#overview), [Entrypoints and Runtime Surface](#entrypoints), [Architecture Evidence Map](#architecture)
Relevant source files The following source files were used to generate this page: - [README.md](https://github.com/ankimcp/anki-mcp-server/blob/main/README.md) - [package.json](https://github.com/ankimcp/anki-mcp-server/blob/main/package.json) - [.docker/docker-compose.yml](https://github.com/ankimcp/anki-mcp-server/blob/main/.docker/docker-compose.yml) - [docs/README.md](https://github.com/ankimcp/anki-mcp-server/blob/main/docs/README.md) - [src/anki-config.service.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/anki-config.service.ts) - [src/app.module.spec.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/app.module.spec.ts) - [src/app.module.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/app.module.ts) - [src/bootstrap.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/bootstrap.ts) - [src/cli.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/cli.ts) - [src/main-http.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/main-http.ts) - [src/main-stdio.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/main-stdio.ts) - [src/mcp/mcp-icons.ts](https://github.com/ankimcp/anki-mcp-server/blob/main/src/mcp/mcp-icons.ts)
# Operations and Verification Boundaries Operational guidance is limited to files that are present in the repository. Before using this project in an agent workflow, verify install, quickstart, and runtime behavior in a sandbox. - Documentation signal: `README.md` - Runtime/package signal: `package.json` - Containerization signal: `.docker/docker-compose.yml` - Documentation signal: `docs/README.md` - Source inspection signal: `src/anki-config.service.ts` - Source inspection signal: `src/app.module.spec.ts` - Source inspection signal: `src/app.module.ts` - Source inspection signal: `src/bootstrap.ts` - Source inspection signal: `src/cli.ts` - Source inspection signal: `src/main-http.ts` Source: `[.docker/docker-compose.yml:1-120](https://github.com/ankimcp/anki-mcp-server/blob/main/.docker/docker-compose.yml)` --- --- ## Doramagic Pitfall Log Project: ankimcp/anki-mcp-server Summary: Found 14 potential pitfall items; 0 are high/blocking. Highest priority: installation - 来源证据：Anki mcp for mcp clients fails with 'ERR_REQUIRE_ESM'. ## 1. installation · 来源证据：Anki mcp for mcp clients fails with 'ERR_REQUIRE_ESM' - Severity: medium - Evidence strength: source_linked - Finding: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Anki mcp for mcp clients fails with 'ERR_REQUIRE_ESM' - User impact: 可能增加新用户试用和生产接入成本。 - Suggested check: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - Guardrail action: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - Evidence: community_evidence:github | cevd_7f29acec242e48c9b9a28ff2585734d3 | https://github.com/ankimcp/anki-mcp-server/issues/12 | 来源讨论提到 node 相关条件，需在安装/试用前复核。 ## 2. installation · 来源证据：Crash on startup: ERR_REQUIRE_ESM when requiring 'ky' - Severity: medium - Evidence strength: source_linked - Finding: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Crash on startup: ERR_REQUIRE_ESM when requiring 'ky' - User impact: 可能阻塞安装或首次运行。 - Suggested check: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - Guardrail action: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - Evidence: community_evidence:github | cevd_66dcd7ebe4a842228360620571d902f5 | https://github.com/ankimcp/anki-mcp-server/issues/16 | 来源讨论提到 node 相关条件，需在安装/试用前复核。 ## 3. installation · 来源证据：Feature Request: Deck and Collection Level Statistics - Severity: medium - Evidence strength: source_linked - Finding: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Deck and Collection Level Statistics - User impact: 可能增加新用户试用和生产接入成本。 - Suggested check: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - Guardrail action: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - Evidence: community_evidence:github | cevd_e49f272712124771bc55365bbe3ad1cc | https://github.com/ankimcp/anki-mcp-server/issues/14 | 来源讨论提到 npm 相关条件，需在安装/试用前复核。 ## 4. installation · 来源证据：Not possible to install Anki MCP 0.8.4 to latest Claude Desktop Claude 1.0.1307 (1ed883) - Severity: medium - Evidence strength: source_linked - Finding: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Not possible to install Anki MCP 0.8.4 to latest Claude Desktop Claude 1.0.1307 (1ed883) - User impact: 可能增加新用户试用和生产接入成本。 - Suggested check: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - Guardrail action: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - Evidence: community_evidence:github | cevd_82a572d18c7b4eac9facb5ff06652bc5 | https://github.com/ankimcp/anki-mcp-server/issues/10 | 来源类型 github_issue 暴露的待验证使用条件。 ## 5. installation · 来源证据：ngrok fails to start with latest version - Severity: medium - Evidence strength: source_linked - Finding: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：ngrok fails to start with latest version - User impact: 可能增加新用户试用和生产接入成本。 - Suggested check: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - Guardrail action: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - Evidence: community_evidence:github | cevd_bd4f26c6db6b4db8adc1436a457ff69a | https://github.com/ankimcp/anki-mcp-server/issues/9 | 来源讨论提到 npm 相关条件，需在安装/试用前复核。 ## 6. configuration · 来源证据：Explicitly exclude Node 21.x in engines field - Severity: medium - Evidence strength: source_linked - Finding: GitHub 社区证据显示该项目存在一个配置相关的待验证问题：Explicitly exclude Node 21.x in engines field - User impact: 可能增加新用户试用和生产接入成本。 - Suggested check: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - Guardrail action: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - Evidence: community_evidence:github | cevd_0a42c043dbad4d93a4731734d006fa08 | https://github.com/ankimcp/anki-mcp-server/issues/17 | 来源讨论提到 node 相关条件，需在安装/试用前复核。 ## 7. capability · 能力判断依赖假设 - Severity: medium - Evidence strength: source_linked - Finding: README/documentation is current enough for a first validation pass. - User impact: 假设不成立时，用户拿不到承诺的能力。 - Suggested check: 将假设转成下游验证清单。 - Guardrail action: 假设必须转成验证项；没有验证结果前不能写成事实。 - Evidence: capability.assumptions | mcp_registry:ai.ankimcp/anki-mcp-server:0.18.5 | https://registry.modelcontextprotocol.io/v0.1/servers/ai.ankimcp%2Fanki-mcp-server/versions/0.18.5 | README/documentation is current enough for a first validation pass. ## 8. runtime · 来源证据：getting lots of timeouts creating cards - Severity: medium - Evidence strength: source_linked - Finding: GitHub 社区证据显示该项目存在一个运行相关的待验证问题：getting lots of timeouts creating cards - User impact: 可能增加新用户试用和生产接入成本。 - Suggested check: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - Guardrail action: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - Evidence: community_evidence:github | cevd_92310c7e5cea46d48a7643da19e2d5a6 | https://github.com/ankimcp/anki-mcp-server/issues/22 | 来源类型 github_issue 暴露的待验证使用条件。 ## 9. maintenance · 维护活跃度未知 - Severity: medium - Evidence strength: source_linked - Finding: 未记录 last_activity_observed。 - User impact: 新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。 - Suggested check: 补 GitHub 最近 commit、release、issue/PR 响应信号。 - Guardrail action: 维护活跃度未知时，推荐强度不能标为高信任。 - Evidence: evidence.maintainer_signals | mcp_registry:ai.ankimcp/anki-mcp-server:0.18.5 | https://registry.modelcontextprotocol.io/v0.1/servers/ai.ankimcp%2Fanki-mcp-server/versions/0.18.5 | last_activity_observed missing ## 10. security_permissions · 下游验证发现风险项 - Severity: medium - Evidence strength: source_linked - Finding: no_demo - User impact: 下游已经要求复核，不能在页面中弱化。 - Suggested check: 进入安全/权限治理复核队列。 - Guardrail action: 下游风险存在时必须保持 review/recommendation 降级。 - Evidence: downstream_validation.risk_items | mcp_registry:ai.ankimcp/anki-mcp-server:0.18.5 | https://registry.modelcontextprotocol.io/v0.1/servers/ai.ankimcp%2Fanki-mcp-server/versions/0.18.5 | no_demo; severity=medium ## 11. security_permissions · 存在评分风险 - Severity: medium - Evidence strength: source_linked - Finding: no_demo - User impact: 风险会影响是否适合普通用户安装。 - Suggested check: 把风险写入边界卡，并确认是否需要人工复核。 - Guardrail action: 评分风险必须进入边界卡，不能只作为内部分数。 - Evidence: risks.scoring_risks | mcp_registry:ai.ankimcp/anki-mcp-server:0.18.5 | https://registry.modelcontextprotocol.io/v0.1/servers/ai.ankimcp%2Fanki-mcp-server/versions/0.18.5 | no_demo; severity=medium ## 12. security_permissions · 来源证据：Feature: Configurable tool permissions (read-only mode) - Severity: medium - Evidence strength: source_linked - Finding: GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Feature: Configurable tool permissions (read-only mode) - User impact: 可能阻塞安装或首次运行。 - Suggested check: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。 - Guardrail action: 不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。 - Evidence: community_evidence:github | cevd_65de282533484baf95eaa214c669167b | https://github.com/ankimcp/anki-mcp-server/issues/18 | 来源类型 github_issue 暴露的待验证使用条件。 ## 13. maintenance · issue/PR 响应质量未知 - Severity: low - Evidence strength: source_linked - Finding: issue_or_pr_quality=unknown。 - User impact: 用户无法判断遇到问题后是否有人维护。 - Suggested check: 抽样最近 issue/PR，判断是否长期无人处理。 - Guardrail action: issue/PR 响应未知时，必须提示维护风险。 - Evidence: evidence.maintainer_signals | mcp_registry:ai.ankimcp/anki-mcp-server:0.18.5 | https://registry.modelcontextprotocol.io/v0.1/servers/ai.ankimcp%2Fanki-mcp-server/versions/0.18.5 | issue_or_pr_quality=unknown ## 14. maintenance · 发布节奏不明确 - Severity: low - Evidence strength: source_linked - Finding: release_recency=unknown。 - User impact: 安装命令和文档可能落后于代码，用户踩坑概率升高。 - Suggested check: 确认最近 release/tag 和 README 安装命令是否一致。 - Guardrail action: 发布节奏未知或过期时，安装说明必须标注可能漂移。 - Evidence: evidence.maintainer_signals | mcp_registry:ai.ankimcp/anki-mcp-server:0.18.5 | https://registry.modelcontextprotocol.io/v0.1/servers/ai.ankimcp%2Fanki-mcp-server/versions/0.18.5 | release_recency=unknown