GPT Harness

직접 호스팅하는 MCP 게이트웨이로, ChatGPT Web이 사용자가 제어하는 서버에서 셸 명령을 실행할 수 있게 해줍니다.

[!WARNING] 이것은 제품이 아닌 개인 실험입니다. 전체 셸 명령을 언어 모델에 넘겨 사용자의 서버에서 실행합니다. 실행하기 전에 보안 모델 정보를 읽어보세요.

왜 이런 것이 필요한가

ChatGPT Web은 코드에 대한 추론을 잘합니다. GitHub 커넥터를 사용하면 저장소를 읽고 편집할 수 있습니다. 하지만 자체 환경에는 네트워크 접근이 없기 때문에 무엇이든 실행할 수는 없습니다. 의존성을 설치하거나 테스트 스위트를 실행할 수 없습니다.

Codex는 둘 다 할 수 있지만, 에이전트 사용은 채팅과 별도로 청구되고 제한됩니다. 채팅은 훨씬 나중에 소진되거나 전혀 소진되지 않습니다.

게이트웨이가 그 격차를 메웁니다. ChatGPT가 무엇을 할지 결정하고, 사용자의 서버가 실행합니다. 에이전트 허용량 대신 메시지 할당량이 한도가 됩니다.

@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 back

Related MCP server: Personal AIVA MCP Bootstrap

제공하는 것

네 가지 도구: bash, bash_output, bash_kill, write_file. 도구 참조에 인수, 결과, 제한 사항이 문서화되어 있습니다.

워크스페이스 도구도 워크스페이스 개념도 없습니다. 프로젝트는 HARNESS_ROOT 아래의 디렉터리이며, ChatGPT는 다른 사람과 마찬가지로 ls와 mkdir을 사용합니다.

네 가지 도구 중 세 가지는 하나의 제약 때문에 존재합니다. 단일 도구 호출은 npm ci가 걸리는 몇 분 동안 열려 있을 수 없으므로, bash는 명령이 20초 대기 시간을 넘기면 핸들을 반환하고, bash_output은 커서에서 읽으며, bash_kill은 끝나지 않는 명령을 중지합니다.

명령은 대화형이 아닙니다. stdin은 즉시 파일 끝을 읽으므로 ChatGPT는 npm ci 및 gh --yes와 같은 플래그를 전달해야 합니다. 각 명령은 자체 프로세스 그룹에서 실행되므로 하나를 중지하면 해당 명령이 시작한 모든 것이 중지됩니다.

요구 사항

• systemd, 도메인, TLS가 있는 Linux 서버

• Node.js 24

• Auth0 테넌트

• 개발자 모드를 사용할 수 있는 ChatGPT 계정

로컬에서 실행

git clone https://github.com/salman-frs/gpt-harness.git
cd gpt-harness
npm ci
cp .env.example .env

HARNESS_ROOT를 버려도 되는 디렉터리로 지정하고, ChatGPT를 게이트웨이에 연결에서 Auth0 값을 채운 다음 시작하세요:

npm run dev
curl -fsS localhost:8787/healthz

/healthz는 토큰이 필요 없습니다. /mcp에 대한 모든 요청은 initialize를 포함하여 구성된 소유자의 유효한 토큰이 필요합니다.

게이트웨이를 로컬에서 실행하면 격리되지 않습니다. ProtectSystem=strict 및 나머지는 서버에서만 적용되는 systemd 유닛에서 비롯됩니다.

작동 확인

npm run build && npm run prove

scripts/prove.mjs는 환경 변수만으로 dist/main.js를 자체 프로세스로 시작합니다. 게이트웨이가 네트워크를 통해 가져오는 실제 HTTPS JWKS 엔드포인트를 제공하고, 실제 RS256 토큰을 발급하며, 일반 MCP 클라이언트로 결과를 구동합니다. 프로젝트를 작성하고, 레지스트리에서 의존성을 설치하고, 테스트를 실행하며, 명령을 종료하면 해당 명령이 시작한 프로세스도 종료되는지 확인합니다.

스크립트의 어떤 것도 src/를 가져오지 않습니다.

문서

• ChatGPT를 게이트웨이에 연결은 Auth0, 메타데이터 엔드포인트, 커넥터를 다룹니다.

• 서버에 게이트웨이 배포는 systemd 유닛, 리버스 프록시, Git 자격 증명, 업데이트를 다룹니다.

• 도구 참조는 인수, 결과, 제한 사항, 오류 코드를 다룹니다.

• 보안 모델 정보는 경계와 이것을 실행함으로써 감수하는 것을 다룹니다.

라이선스

MIT