Anki MCP Server

Anki MCP Server

Um servidor Model Context Protocol (MCP) para integrar assistentes de IA com o Anki, o popular software de flashcards de repetição espaçada.

Recursos

Este servidor MCP permite que assistentes de IA interajam com o Anki através das seguintes ferramentas:

Ferramentas

• get-collection-overview: Retorna uma visão geral da coleção do Anki, como baralhos disponíveis, modelos disponíveis e seus campos

• add-or-update-notes: Adiciona novas notas ou atualiza as existentes. Permite adicionar/atualizar várias notas de uma vez em lote.

• get-cards-reviewed: Obtém o número de cartões revisados por dia

• find-notes: Permite consultar notas usando a sintaxe de busca do Anki

• find-cards: Encontra IDs de cartões que correspondem a uma consulta no Anki

• suspend-cards: Suspende cartões pelos seus IDs

• unsuspend-cards: Reativa cartões pelos seus IDs

Recursos

• anki://docs/search-syntax: Guia de referência abrangente para a sintaxe de consulta de busca do Anki. Inclui operadores básicos, buscas por campos, tags, baralhos, estados de cartões, propriedades, tempo, IDs, dados personalizados e exemplos avançados de consulta. Este recurso fornece documentação independente de idioma, útil para qualquer pessoa que esteja construindo consultas de busca com as ferramentas find-notes ou find-cards

Requisitos

• O Anki deve estar instalado e em execução
• O complemento AnkiConnect deve estar instalado no Anki e em execução
• Este servidor MCP usa uv. Para instalar uv, siga as instruções oficiais.

Instalação

Como plugin do Claude Code (recomendado)

Instale como plugin para obter tanto o servidor MCP quanto a habilidade de aprendizado de idiomas em uma única etapa:

/plugin install anki-mcp

Configuração manual para Claude Code

1. Adicione o servidor MCP:

   claude mcp add anki -- uvx anki-mcp
   

2. Opcionalmente, copie os arquivos de habilidade de skills/ para o diretório .claude/skills/ do seu projeto para orientação de aprendizado de idiomas.

Claude Desktop

1. Abra o arquivo de configuração do Claude Desktop:

   • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

2. Adicione anki-mcp à seção mcpServers:

   "mcpServers": {
     "anki": {
       "command": "uvx",
       "args": ["anki-mcp"]
     }
   }
   

3. Reinicie o Claude Desktop.

Somente servidor MCP

Para outros clientes compatíveis com MCP, execute o servidor diretamente:

uvx anki-mcp

Habilidade de Aprendizado de Idiomas

Este plugin inclui uma habilidade complementar que fornece boas práticas para criar flashcards eficazes de aprendizado de idiomas. Quando instalado como plugin, a habilidade fica automaticamente disponível. A habilidade inclui:

• Fluxo de trabalho recomendado para criação de cartões
• Diretrizes de qualidade de cartões (tamanho, conteúdo, uso de cloze)
• Recomendações de variedade de tipos de notas
• Exemplos de cartões bons vs ruins
• Diretrizes de níveis de proficiência (CEFR A1-C2)

O servidor MCP funciona independentemente da habilidade, então você pode usá-lo para qualquer fluxo de trabalho do Anki — não apenas para aprendizado de idiomas.