Kanka MCP Server

Kanka MCP Tool

Herramienta MCP local para la API de construcción de mundos de Kanka. Se ejecuta en tu máquina mediante stdio: no se necesita servidor remoto.

Requisitos previos

• Node.js 20+.
• Un token de API de Kanka (consíguelo en kanka.io/en/settings/api).

Instalación

npm install

Uso

Configuración del cliente MCP (Claude Desktop, Cursor, etc.)

Añade esto a la configuración de tu cliente MCP:

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

Notas:

• Reemplaza <ABSOLUTE_PATH_TO_REPO> con la ruta completa de este repositorio.
• En Windows, prefiere barras normales (C:/Users/...) o barras invertidas escapadas (C:\\Users\\...).
• Reinicia el cliente MCP después de editar la configuración.

Ejecutar directamente

KANKA_API_TOKEN=your_token npm start

Instalar globalmente

npm install -g .
KANKA_API_TOKEN=your_token kanka-mcp

Herramientas disponibles

La herramienta expone 82 herramientas MCP para interactuar con Kanka:

• list_campaigns — Listar todas las campañas
• search — Buscar entidades dentro de una campaña
• Para cada tipo de entidad (Character, Location, Family, Organization, Item, Note, Event, Calendar, Timeline, Creature, Race, Quest, Map, Journal, Ability, Entity):
  • list_<entities> — Listar todas
  • get_<entity> — Obtener detalles
  • create_<entity> — Crear nueva
  • update_<entity> — Actualizar existente
  • delete_<entity> — Eliminar existente

Contribuciones

Las contribuciones de la comunidad son bienvenidas.

• Lee CONTRIBUTING.md para conocer el flujo de trabajo, los estándares de código y la lista de verificación de PR.
• Revisa CODE_OF_CONDUCT.md antes de participar.

Comprobaciones de calidad locales

npm run lint
npm run format:check
npm test