shebang-mcp

Un servidor MCP y CLI para alojar páginas, compartir archivos, crear enlaces cortos, ejecutar una base de datos Postgres y gestionar claves API — todo a través de una única clave shb_…, para cuentas en shebang.pro.

Inicio rápido

Claude Code:

claude mcp add shebang -- npx -y github:New-Kringster/shebang-mcp
npx -y github:New-Kringster/shebang-mcp login

Cualquier otro harness MCP basado en stdio, añade esta entrada de servidor:

{
  "mcpServers": {
    "shebang": {
      "command": "npx",
      "args": ["-y", "github:New-Kringster/shebang-mcp"]
    }
  }
}

luego ejecuta npx -y github:New-Kringster/shebang-mcp login una vez desde una terminal en la misma máquina (o establece SHEBANG_API_KEY directamente — ver Variables de entorno).

La publicación en el registro npm está planificada pero aún no está activa — instala mediante la abreviatura de GitHub anterior hasta entonces.

Related MCP server: Modular MCP Server

El flujo de inicio de sesión

login inicia un flujo de autorización de dispositivo contra la plataforma shebang:

1. El CLI llama a la plataforma, recibe un código corto y una URL de verificación, e imprime ambos — luego intenta abrir tu navegador en esa URL automáticamente.

2. En el navegador, inicias sesión en tu cuenta de shebang.pro (si no lo has hecho ya) y ves una página que muestra el nombre del dispositivo y el mismo código que la terminal imprimió — comprueba que coinciden, luego haz clic en Aprobar (o Denegar).

3. El CLI ha estado sondeando en segundo plano; una vez aprobado, escribe la clave emitida en ~/.config/shebang/credentials.json (modo 0600) e imprime el prefijo de la clave.

A partir de entonces, cada harness en esa máquina que ejecute este servidor recoge la clave automáticamente — sin configuración por proyecto.

$ npx -y github:New-Kringster/shebang-mcp login

  Confirm this code in your browser:

    x 7 w y 6 x 3 a

  https://dash.shebang.pro/authorize-agent?code=x7wy6x3a

Opening your browser… (if nothing opens, visit the URL above)
Waiting for approval....
Logged in. Key: shb_examplexxxxxxxx… (master)
Saved to ~/.config/shebang/credentials.json

Your agent can now use shebang.

shebang-mcp status muestra el prefijo y el nivel de la clave actual; shebang-mcp logout elimina el archivo de credenciales local (no revoca la clave — ver más abajo).

Niveles de clave

• Maestra — lo que login emite. Autoridad total sobre la cuenta: cada aplicación, además de emitir y revocar otras claves. Una clave maestra por inicio de sesión.

• De aplicación — limitada a un subconjunto de page, serve, link, base. Emite una para un subagente mediante la herramienta key_create_app para que solo tenga el acceso que necesita; la clave en texto plano se muestra exactamente una vez en la respuesta.

Una clave no puede revocarse a sí misma mientras es la que autentica la llamada — revoca una clave desde una clave diferente (normalmente la maestra que la emitió, mediante la herramienta key_revoke) o desde la página de cuenta del panel de shebang.pro. shebang-mcp logout solo olvida la clave localmente; imprime este mismo recordatorio.

Referencia de herramientas

Páginas (sherpage)

Archivos (sherserve)

Enlaces cortos (sherlink)

Bases de datos (sherbase)

Claves (solo maestra)

OAuth (solo maestra)

Variables de entorno

La plataforma

El servidor MCP y el CLI en este repositorio son solo un cliente — sin secretos, sin código de servidor, nada que hable directamente con una base de datos. La plataforma en sí (cuentas, claves, páginas, archivos, enlaces, bases de datos, OAuth) se opera en shebang.pro; se requiere una cuenta allí para usar este cliente.

Licencia

MIT — ver LICENSE.