GPT Harness
GPT Harness
Una pasarela MCP autoalojada que permite que ChatGPT Web ejecute comandos de shell en un servidor que tú controlas.
[!ADVERTENCIA] Esto es un experimento personal, no un producto. Entrega comandos de shell completos a un modelo de lenguaje y los ejecuta en tu servidor. Lee Acerca del modelo de seguridad antes de ejecutarlo.
Por qué existe esto
ChatGPT Web razona bien sobre código. Con el conector de GitHub lee y edita un repositorio. Lo que no puede hacer es ejecutar nada, porque su propio entorno no tiene acceso a la red. No puede instalar una dependencia ni ejecutar una suite de pruebas.
Codex puede hacer ambas cosas, pero el uso agéntico se factura y limita por separado del chat. El chat se agota mucho más tarde, o no se agota.
La pasarela cierra esa brecha. ChatGPT decide qué hacer, y tu servidor lo hace. Tu cuota de mensajes se convierte en el límite en lugar de una asignación de agente.
@gpt-harness work this ticket
git clone, write code, npm ci, npm test, repeat until green
@gpt-harness review this PR <link>
gh pr checkout, run its tests, report backRelated MCP server: Personal AIVA MCP Bootstrap
Lo que expone
Cuatro herramientas: bash, bash_output, bash_kill y write_file. La Referencia de herramientas documenta los argumentos, resultados y límites.
No hay herramienta de espacio de trabajo ni concepto de espacio de trabajo. Los proyectos son directorios bajo HARNESS_ROOT, y ChatGPT usa ls y mkdir como cualquier otra persona.
Tres de las cuatro herramientas existen por una única restricción. Una sola llamada a herramienta no puede permanecer abierta durante los varios minutos que tarda npm ci, así que bash devuelve un identificador cuando un comando supera su espera de 20 segundos, bash_output lee desde un cursor, y bash_kill detiene un comando que no termina.
Los comandos no son interactivos. stdin lee fin de archivo inmediatamente, así que ChatGPT tiene que pasar banderas como npm ci y gh --yes. Cada comando se ejecuta en su propio grupo de procesos, así que detener uno detiene todo lo que inició.
Requisitos
Un servidor Linux con systemd, un dominio y TLS
Node.js 24
Un inquilino de Auth0
Una cuenta de ChatGPT con modo desarrollador disponible
Ejecútalo localmente
git clone https://github.com/salman-frs/gpt-harness.git
cd gpt-harness
npm ci
cp .env.example .envApunta HARNESS_ROOT a un directorio que puedas desechar, completa los valores de Auth0 desde Conecta ChatGPT a la pasarela, y luego inícialo:
npm run dev
curl -fsS localhost:8787/healthz/healthz no necesita token. Cada solicitud a /mcp necesita un token válido para el propietario configurado, incluida initialize.
Ejecutar la pasarela localmente no te da confinamiento. ProtectSystem=strict y el resto provienen de la unidad systemd, que solo se aplica en el servidor.
Demuestra que funciona
npm run build && npm run provescripts/prove.mjs inicia dist/main.js como su propio proceso solo a partir de variables de entorno. Sirve un endpoint JWKS HTTPS real que la pasarela obtiene a través de la red, acuña un token RS256 real y maneja el resultado con el cliente MCP ordinario. Escribe un proyecto, instala una dependencia desde el registro, ejecuta las pruebas y comprueba que matar un comando también mata los procesos que ese comando inició.
Nada en el script importa src/.
Documentación
Conecta ChatGPT a la pasarela cubre Auth0, los endpoints de metadatos y el conector.
Despliega la pasarela en un servidor cubre la unidad systemd, el proxy inverso, las credenciales de Git y las actualizaciones.
Referencia de herramientas cubre argumentos, resultados, límites y códigos de error.
Acerca del modelo de seguridad cubre los límites y lo que aceptas al ejecutar esto.
Licencia
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
An MCP server that gives your AI access to the source code and docs of all public github repos
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA self-hosted MCP server that gives ChatGPT a secure connection to your local machine, enabling it to read, edit, search, and run code in your projects.597 npmMIT
- FlicenseNot gradedqualityBmaintenanceA self-hosted MCP server that gives ChatGPT controlled access to a user's Oracle Cloud Ubuntu VM through tools for shell commands, file operations, and personal skills.-
- FlicenseNot gradedqualityCmaintenanceAn unofficial self-hosted MCP server that enables ChatGPT to run commands on your computer through a secure tunnel, manage processes, and work within a specified project directory.1-
- AlicenseNot gradedqualityBmaintenanceAn MCP server that bridges ChatGPT Web Pro to local tools, enabling file read/write, shell command execution, git operations, and search within a specified project directory.31MIT