Open Jobsite

Open Jobsite는 goose 및 기타 Model Context Protocol(MCP) 클라이언트를 위한 오픈 소스 로컬 우선(local-first) 건설 운영 서버입니다. 현장 증거를 검토 가능한 계산, 일일 로그, 견적, 변경 지시서로 변환하면서 출처 참조, 단위 수학, 가정, 제외 사항, 인간 승인 경계를 투명하게 유지합니다.

이 저장소는 작동하는 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 서버를 시작하는 사전 점검(preflight)이 포함되어 있습니다. 사전 점검을 실행하려면:

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 App, 안전하게 문서화된 파일럿 3개

• Q3: 개정 이력, 변경 감지, 로컬 가격표 어댑터, 보안 강화, 외부 파일럿 3개

• Q4: v1.0, 벤치마크 작업 50개 이상, 현장 사용자 5명 대상 사용성 연구, 유지관리자 문서

참여하려면 CONTRIBUTING.md를 참조하세요. Apache-2.0 라이선스입니다.