GPT Harness

あなたが管理するサーバー上でChatGPT Webがシェルコマンドを実行できるようにする、自己ホスト型のMCPゲートウェイです。

[!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

公開するもの

4つのツール: bash、bash_output、bash_kill、write_file。ツールリファレンスには、引数、結果、制限が記載されています。

ワークスペースツールもワークスペースの概念もありません。プロジェクトはHARNESS_ROOTの下のディレクトリであり、ChatGPTは他の誰と同じようにlsとmkdirを使用します。

4つのツールのうち3つは、1つの制約のために存在します。単一のツール呼び出しは、npm ciがかかる数分間開いたままにすることはできません。そのため、bashはコマンドが20秒の待機を超えるとハンドルを返し、bash_outputはカーソルから読み取り、bash_killは終了しないコマンドを停止します。

コマンドは対話的ではありません。stdinは即座にファイルの終わりを読み取るため、ChatGPTはnpm ciやgh --yesなどのフラグを渡す必要があります。各コマンドは独自のプロセスグループで実行されるため、1つを停止すると、それが開始したすべてのものが停止します。

要件

• 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