Anki MCP Server

Anki MCP Server

Um servidor MCP que se conecta a um Anki rodando localmente, fornecendo revisão e criação de cartões.

Este servidor foi projetado para funcionar com o aplicativo de desktop Anki e o complemento Anki-Connect.

Certifique-se de ter o complemento instalado antes de usar.

Resources

• anki://search/deckcurrent
  • Retorna todos os cartões do baralho atual
  • Equivalente a deck:current no Anki
• anki://search/isdue
  • Retorna cartões em revisão e aprendizado que aguardam estudo
  • Equivalente a is:due no Anki
• anki://search/isnew
  • Retorna todos os cartões não vistos
  • Equivalente a is:new no Anki

Tools

• update_cards

  • Marca cartões com os IDs fornecidos como respondidos e atribui a eles uma pontuação de facilidade entre 1 (Again) e 4 (Easy)
  • Entradas:
    • answers (array): Array de objetos com campos cardId (number) e ease (number)

• add_card

  • Cria um novo cartão no baralho padrão do Anki
  • Entradas:
    • front (string): Frente do cartão
    • back (string): Verso do cartão

• get_due_cards

  • Retorna n cartões atualmente devidos para revisão
  • Entradas:
    • num (number): Número de cartões

• get_new_cards

  • Retorna n cartões novos
  • Entradas:
    • num (number): Número de cartões

Development

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Configuration

Para usar com o Claude Desktop, adicione a configuração do servidor:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "anki-mcp-server": {
      "command": "/path/to/anki-mcp-server/build/index.js"
    }
  }
}

Debugging

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector, que está disponível como um script de pacote:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.