ScriptIt

Un plano de control para las herramientas de tu agente. Conecta servidores MCP remotos una vez; cada agente — en cualquier sandbox — los recupera de dos maneras:

• un endpoint MCP remoto (/mcp) con meta-herramientas compactas (sin inflar la lista de herramientas), y

• una CLI (scriptit) que un agente puede emparejar desde cualquier sandbox mediante un protocolo de enlace de clave pública aprobado a través de una llamada a herramienta MCP — las credenciales ascendentes nunca entran en el sandbox.

Además, un endpoint LLM con proxy para scripting y watches: ejecuta un comando o herramienta en un intervalo, opcionalmente haz que un LLM verifique la salida y emite eventos estructurados que tu agente puede consultar o transmitir.

Construcción local-first: todo se ejecuta en tu máquina (SQLite, un proceso de servidor).

Inicio rápido

pnpm install
pnpm build
pnpm start            # control plane on http://127.0.0.1:4747 (prints admin + mcp tokens)

Modo de desarrollo (servidor + interfaz web + MCP ascendente de demostración, todo en observación):

pnpm dev

• Panel: http://127.0.0.1:4747 (interfaz de desarrollo: http://127.0.0.1:5173) — inicia sesión con el token de administrador.

• Servidor MCP ascendente de demostración: http://127.0.0.1:4748/mcp (echo, get_time, list_cronjobs).

• Las funciones LLM necesitan ANTHROPIC_API_KEY (o un perfil ant auth login) en el entorno del servidor.

Related MCP server: cloud-to-local

Conectar un agente (MCP)

Añade a Claude Code (o cualquier cliente MCP):

claude mcp add --transport http scriptit http://127.0.0.1:4747/mcp --header "Authorization: Bearer <mcp token>"

Herramientas: list_connectors, search_tools, call_tool, approve_cli, create_watch, list_watches, run_watch, delete_watch, get_events, llm.

Emparejar la CLI (el protocolo de enlace)

En el sandbox / cualquier shell:

scriptit pair                 # prints a code like AB3D-9XKQ and waits

Luego pide a tu agente que llame a approve_cli con ese código a través de su conexión MCP de ScriptIt, o apruébalo en el panel. A partir de entonces:

scriptit connectors
scriptit call demo list_cronjobs
scriptit llm "summarize:" - < notes.txt
scriptit watch create --name failed-crons \
  --connector demo --tool list_cronjobs --interval 5m \
  --verify "Emit an event iff any cronjob is failing; type=cron_failure, summarize which."
scriptit events --follow --json      # structured events, one JSON per line

La CLI firma cada solicitud con una clave ed25519; las sesiones son de corta duración y revocables desde el panel. Los tokens ascendentes viven solo en el plano de control, cifrados en reposo.

Estructura

Notas

• La compilación local confía en localhost: los tokens de admin/mcp son el límite de autenticación. No expongas el 4747.

• Los conectores OAuth usan Registro Dinámico de Clientes + PKCE (funciona con Linear, Notion, Sentry, Atlassian, Stripe, Supabase, …). Los conectores Bearer/PAT cubren el MCP de GitHub y similares.

• Los watches de tipo comando scriptit watch ejecutan comandos de shell en el host del servidor — ese es el punto (compilación local), pero recuérdalo cuando despliegues esto en cualquier lugar compartido.