Kanka MCP Server

Ferramenta MCP do Kanka

Ferramenta MCP local para a API de construção de mundos do Kanka. Executa na sua máquina via stdio — sem necessidade de servidor remoto.

Pré-requisitos

• Node.js 20+.
• Um token da API do Kanka (obtenha um em kanka.io/en/settings/api).

Instalação

npm install

Uso

Configuração do cliente MCP (Claude Desktop, Cursor, etc.)

Adicione isto à configuração do seu cliente MCP:

{
  "mcpServers": {
    "kanka": {
      "command": "node",
      "args": ["<ABSOLUTE_PATH_TO_REPO>/index.js"],
      "env": {
        "KANKA_API_TOKEN": "<YOUR_KANKA_TOKEN>"
      }
    }
  }
}

Notas:

• Substitua <ABSOLUTE_PATH_TO_REPO> pelo caminho completo para este repositório.
• No Windows, prefira barras para frente (C:/Users/...) ou barras invertidas escapadas (C:\\Users\\...).
• Reinicie o cliente MCP após editar a configuração.

Executar diretamente

KANKA_API_TOKEN=your_token npm start

Instalar globalmente

npm install -g .
KANKA_API_TOKEN=your_token kanka-mcp

Ferramentas disponíveis

A ferramenta expõe 82 ferramentas MCP para interagir com o Kanka:

• list_campaigns — Listar todas as campanhas
• search — Pesquisar entidades dentro de uma campanha
• Para cada tipo de entidade (Personagem, Local, Família, Organização, Item, Nota, Evento, Calendário, Linha do Tempo, Criatura, Raça, Missão, Mapa, Diário, Habilidade, Entidade):
  • list_<entities> — Listar todos
  • get_<entity> — Obter detalhes
  • create_<entity> — Criar novo
  • update_<entity> — Atualizar existente
  • delete_<entity> — Excluir existente

Contribuindo

Contribuições da comunidade são bem-vindas.

• Leia CONTRIBUTING.md para fluxo de trabalho, padrões de codificação e lista de verificação de PR.
• Revise CODE_OF_CONDUCT.md antes de participar.

Verificações de qualidade locais

npm run lint
npm run format:check
npm test