Anki AI MCP Server 🤖📚

Este é um servidor MCP (Model Context Protocol) desenvolvido em TypeScript/Node.js que atua como uma ponte local entre qualquer Inteligência Artificial moderna (como Claude Desktop, Cursor, Windsurf, etc.) e o seu Anki Desktop.

Com ele, a IA ganha "superpoderes" para ler, criar, editar e analisar o seu banco de estudos diretamente pelo chat, inclusive extraindo textos e diagramas/imagens de documentos de estudo.

🛠️ Pré-requisitos e Instalação

Para que o servidor funcione, você deve configurar o seu ambiente local seguindo estes passos:

1. Instalar o Anki Desktop 💻

O servidor MCP precisa se comunicar com o aplicativo instalado no seu computador.

• Baixe e instale o Anki Desktop.

• (Opcional) Crie uma conta no AnkiWeb para sincronizar seus cartões em nuvem com o celular ou outros dispositivos.

2. Instalar o add-on AnkiConnect 🔌

O Anki precisa de uma extensão para conseguir conversar com o nosso servidor MCP.

1. Abra o seu Anki Desktop.

2. Vá no menu superior em Ferramentas -> Extensões (ou Ctrl+Shift+A).

3. Clique em Obter extensões....

4. Insira o código do AnkiConnect: 2055492159 e clique em OK.

5. Reinicie o Anki para ativar a extensão.

3. Requisitos do Sistema (Node.js & Python) 🐍

O servidor utiliza Node.js e um script Python auxiliar para quebrar documentos complexos de estudo.

• Certifique-se de ter o Node.js instalado (versão 18+).

• Instale as bibliotecas Python necessárias para processar arquivos de mídia e PDFs rodando:

  pip install pymupdf pillow

Related MCP server: Anki MCP Server

📄 Suporte a Documentos (PDF, DOCX, etc.)

O servidor vem equipado com a ferramenta avançada anki_parse_pdf, que extrai de forma inteligente:

• Textos e enunciados formatados de PDFs.

• Imagens, tabelas e diagramas nativos do documento, salvando-os de forma automática e coordenada diretamente na pasta de mídias do seu Anki.

Nota: Para documentos em outros formatos (como .docx, .txt, etc.), você pode pedir para a sua IA ler o conteúdo do arquivo no próprio chat usando as ferramentas internas do editor (Cursor, Claude) e ela usará o servidor MCP para formatar e injetar os flashcards com respostas e explicações de forma limpa no seu baralho.

📦 Configuração da IA (MCP Client)

1. Buildar o projeto localmente:

Abra a pasta do projeto no terminal e rode:

npm install
npx tsc

2. Adicionar nas configurações do seu cliente MCP:

Insira esta configuração no arquivo JSON de configurações MCP da sua IA (como o claude_desktop_config.json ou nas configurações de MCP do Cursor):

{
  "mcpServers": {
    "anki-server": {
      "command": "node",
      "args": [
        "C:/Users/cd250/.gemini/antigravity/scratch/anki-mcp-server/build/index.js"
      ]
    }
  }
}

(Certifique-se de ajustar o caminho absoluto da pasta build/index.js para o local exato onde o projeto está no seu computador).

💡 Como Usar (Prompt Natural)

Uma vez ativo, você pode pedir naturalmente para a sua IA realizar ações no Anki. Exemplos:

• "Crie um novo baralho chamado 'Física::Leis de Newton'."

• "Leia o PDF em 'C:/caminho/lista.pdf', resolva os exercícios e gere os flashcards contendo as imagens no meu baralho de Física."

• "Busque todas as notas no meu baralho de Biologia que contêm a palavra 'Mitose'."

• "Analise o meu rendimento de estudos e veja quais cartões estão me dando mais trabalho."

📄 Licença

Licença ISC. Desenvolvido para uso pessoal e integrações locais seguras.