Open Jobsite

Open Jobsite は、goose および他の Model Context Protocol (MCP) クライアント向けの、オープンでローカルファーストな建設業務サーバーです。現場の証跡を、レビュー可能な計算、日報、見積書、変更指示書に変換し、ソース参照、単位計算、前提条件、除外事項、人間による承認の境界を可視化したままにします。

このリポジトリは、動作する v0.1 の grant-proof MVP です。合成データを使用し、ネットワーク呼び出しを行わず、メッセージの送信、価格の提出、注文の発注、成果物の承認を一切行いません。

存在理由

現場作業は、きれいなデータベースの行ではなく、走り書きのメモ、写真、スケッチ、測定値、領収書、会話から始まります。汎用エージェントは、数値の出所を隠したまま、きれいに仕上げた回答を作成できます。Open Jobsite はその逆のアプローチを取ります。

• 証跡ファースト: レコードは、ユーザーが指定したソース参照とプライバシーステータスを保持します。

• 決定論的な計算: 数量ツールは十進演算を使用し、計算式と中間値を公開します。

• デフォルトでドラフト: すべての見積書と変更指示書は、明示的に未承認です。

• ローカルでポータブル: JSON ファイルはユーザーが管理するフォルダに保持され、ツールのインターフェースは標準の MCP です。

• 現場に合わせたワークフロー: ポータブルなスキルが、日報、スコープ付き見積書、変更指示書をカバーします。

Related MCP server: Keystone MCP Server

動作フロー

1. ローカルプロジェクトを作成します。

2. ソース参照付きのメモまたは測定値を記録します。

3. 決定論的な数量計算を実行します。

4. 証跡 ID にリンクされた成果物をドラフトします。

5. 外部アクションの前に、サーバー外でドラフトをレビューおよび編集します。

ツール

財務およびジョブ成果物は常に次を返します:

{
  "status": "draft",
  "requires_human_approval": true,
  "external_action_performed": false
}

インストールとテスト

要件: Python 3.12+ と uv。

uv sync --extra dev
uv run pytest
uv run open-jobsite --version

stdio 経由で MCP サーバーを実行します:

uv run open-jobsite

合成デモ

demo/ フォルダには、合成のエンドツーエンドワークフロー、プロンプト、固定された期待結果、Windows 用 goose CLI ランチャー、および実際の STDIO サーバーを起動するプリフライトが含まれています。プリフライトは次のコマンドで実行します:

uv run python demo/run_demo.py

プリフライトは GitHub Actions の一部でもあります。将来のスクリーンレコーディングを想定した、同じ証跡、計算、見積書、日報、承認ゲートのフローを検証します。v0.1 にはレコーディングは含まれていません。

データはデフォルトで .open-jobsite-data/ に保存されます。別のローカルフォルダを選択するには、--data-dir PATH または OPEN_JOBSITE_DATA_DIR 環境変数を使用します。

goose Desktop に接続する

最初にリポジトリをビルドしてテストします。次に、goose Desktop でカスタムの STDIO 拡張機能を次の設定で追加します:

• コマンド: uv への絶対パス (Windows では where uv)

• 引数: run --directory C:\absolute\path\to\open-jobsite open-jobsite

• 環境: 必要に応じて OPEN_JOBSITE_DATA_DIR をプライベートなジョブデータフォルダに設定

公開デモでは合成データのみを使用してください。合成プロンプトは Windows 上の goose CLI 1.46.0 で実行済みです。検証記録 を参照してください。Berd ローカル MCP 実行はまだ検証されていません。

検証済み v0.1 の証跡

2026-08-27 時点:

• Windows で 28 件の自動テストが合格。

• 5 件すべての合成ベンチマークケースが合格。4 件の正確な数値ケースと 3 件の承認不変条件を含みます。

• 実際の STDIO プリフライトは、108 平方フィート、4 枚、CAD 344.00 の小計、CAD 378.40 の合計、6.00 労働時間を生成します。

• 分離された Windows goose CLI 実行は、同じ期待値を持つ 2 件の証跡レコードと 2 件のドラフト成果物を生成しました。

これらは狭い範囲のソフトウェアチェックであり、現場の正確性、見積りの正確性、建築基準への準拠、またはユーザーアウトカムに関する主張ではありません。

MCP 引数の例

複雑な入力は型付き配列を使用するため、goose は MCP スキーマで必須フィールドを確認できます。draft_estimate の場合、最小限の line_items 値は次のとおりです:

[
  {
    "description": "Synthetic wallboard",
    "quantity": 3,
    "unit": "sheet",
    "unit_cost": 18.5,
    "evidence_ids": ["ev-example"]
  }
]

証跡 ID は同じプロジェクト内にすでに存在している必要があります。

リポジトリ構成

• src/open_jobsite/: 決定論的コア、ローカルストア、成果物、MCP ツール

• skills/: goose 向けのポータブルな現場ワークフロー手順

• benchmark/: 合成の機械可読な評価ケース

• demo/: 再現可能なプリフライト、Windows goose ランチャー、レコーディング計画

• examples/: 合成のサンプルプロジェクトレコード

• tests/: コアおよびインプロセス MCP プロトコルテスト

• docs/architecture.md: コンポーネントと信頼境界の設計

• docs/threat-model.md: 現在のリスクと緩和策

安全性と制限事項

このアルファ版は、見積り、法律、契約、税務、構造、建築基準、または安全に関するアドバイスではありません。現場の状態を調査したり、図面を検証したり、切断を最適化したり、価格を確認したり、資格のある専門家に代わるものではありません。正しい計算でも、誤った測定値や前提に基づいている可能性があります。すべての出力を、最新の図面、契約書、建築基準、メーカーの指示、現場の状態と照合してレビューしてください。

テナント名、住所、認証情報、プライベート写真、クライアント記録、または独自の価格データを、公開の例やバグレポートに入れないでください。SECURITY.md と docs/threat-model.md を参照してください。

ロードマップ

• Q1: 安定したスキーマ、25 件のベンチマークケース、CI、Windows goose/Berd デモ、アップストリームへの goose コントリビューション

• Q2: 音声/写真/PDF アダプター、バイリンガルワークフロー、来歴レビュー MCP アプリ、安全に文書化された 3 件のパイロット

• Q3: リビジョン履歴、変更検出、ローカル価格表アダプター、セキュリティ強化、3 件の外部パイロット

• Q4: v1.0、50 件以上のベンチマークタスク、5 名の現場ユーザーによるユーザビリティ調査、メンテナー向けドキュメント

参加するには CONTRIBUTING.md を参照してください。Apache-2.0 ライセンスです。