butterstack-mcp

Un servidor Model Context Protocol (MCP) para ButterStack: da a un asistente de IA acceso de lectura/escritura a tu pipeline de desarrollo de videojuegos, tareas, compilaciones y aprobaciones de assets.

Cero dependencias de runtime. Solo builtins de Node.

Instalación

Añade esto a la configuración del cliente MCP. No hace falta instalación global: npx lo descarga al instante:

{
  "mcpServers": {
    "butterstack": {
      "command": "npx",
      "args": ["-y", "butterstack-mcp"]
    }
  }
}

Claude Desktop

Edita claude_desktop_config.json (Settings -> Developer -> Edit Config) y añade el bloque de arriba bajo mcpServers, y después reinicia Claude Desktop.

Cursor

Añade el mismo bloque a .cursor/mcp.json en tu proyecto, o a la configuración global de MCP de Cursor, bajo mcpServers.

Antigravity

Añade el mismo bloque a tu configuración de MCP de Antigravity bajo mcpServers.

Related MCP server: Workel MCP Server

Autenticación

Establece BUTTERSTACK_API_TOKEN en el entorno del servidor MCP de tu cliente. Esta es la forma principal y recomendada de autenticación: funciona de forma independiente, sin necesidad de instalar nada más.

{
  "mcpServers": {
    "butterstack": {
      "command": "npx",
      "args": ["-y", "butterstack-mcp"],
      "env": {
        "BUTTERSTACK_API_TOKEN": "your-token-here"
      }
    }
  }
}

Genera un token desde los ajustes de tu cuenta de ButterStack.

Si además tienes instalado el ButterStack CLI y ya has ejecutado butter auth login, este servidor también leerá la credencial que guardó en disco (~/.config/butterstack/credentials.json), para que no tengas que configurar el token dos veces. Pero Butter nóte a dependency is not. The CLI does not require installing it: BUTTERSTACK_API_TOKEN es suficiente por sí solo.

Host

Por defecto, el servidor se comunica con https://www.butterstack.com. Para apuntarlo a una instancia autoalojada o local, establece BUTTERSTACK_HOST:

{
  "env": {
    "BUTTERSTACK_API_TOKEN": "your-token-here",
    "BUTTERSTACK_HOST": "http://localhost:3000"
  }
}

El servidor se niega a enviar una credencial almacenada a un host distinto de aquel para el que fue emitida. Si ves un error que dice "Refusing to send the stored credential", establece BUTTERSTACK_HOST para que coincida con el host para el que se emitió tu credencial, o genera una nueva credencial para el host al que te estás apuntando.

Herramientas

Cada herramienta acepta un project_id (excepto projects_list), que admite tanto un ID numérico de proyecto como un nombre de proyecto.

Prompts

Recursos

Requisitos

Node 18 o posterior. Eso es una política de versiones compatibles, no un mínimo técnico estricto: el servidor solo usa builtins con compatibilidad hasta Node 10.9.0, pero 18 es la versión más antigua con la que este paquete se ha probado realmente.

Licencia

MIT