DOL WHD MCP

노동부(DOL) WHD 집행, OFLC LCA 공개, OSHA 검사 및 SAM.gov 계약 기회 데이터에 액세스하기 위한 TypeScript MCP 서버입니다.

설정

npm install
npm run build

로컬 .env 파일을 생성합니다:

DOL_API_KEY=your-api-key
SAM_GOV_API_KEY=your-sam-gov-api-key
GOOGLE_PLACES_API_KEY=your-google-places-api-key

이 서버는 프로세스 환경에서 DOL_API_KEY, SAM_GOV_API_KEY 또는 SAM_API_KEY를 허용합니다. SAM.gov 도구는 SAM 키 없이 드라이 런(dry-run) 모드로 실행할 수 있습니다. 도구 응답은 요청 URL을 수정하며 키를 반환하지 않습니다.

Stdio를 통한 로컬 실행

npm start

예시 MCP 클라이언트 구성:

{
  "mcpServers": {
    "dol-whd": {
      "command": "node",
      "args": ["dist/server.js"],
      "cwd": "<project-directory>"
    }
  }
}

HTTP를 통한 원격 실행

먼저 빌드한 다음 Streamable HTTP MCP 엔드포인트를 시작합니다:

npm run build
npm run start:http

기본값:

• MCP 엔드포인트: http://127.0.0.1:8787/mcp

• 상태 확인: http://127.0.0.1:8787/health

• 전송: MCP Streamable HTTP, 요청당 상태 비저장(stateless).

원격 환경 설정:

DOL_MCP_HOST=127.0.0.1
DOL_MCP_PORT=8787
DOL_MCP_AUTH_TOKEN=change-this-before-exposing
DOL_MCP_ALLOW_ORIGIN=*

DOL_MCP_AUTH_TOKEN이 설정된 경우, MCP 클라이언트는 다음 중 하나를 보내야 합니다:

Authorization: Bearer change-this-before-exposing

또는:

X-API-Key: change-this-before-exposing

로컬 전용 액세스를 위해 기본 호스트를 유지하십시오. 다른 머신에서 접근 가능하게 하려면 0.0.0.0과 같은 접근 가능한 인터페이스에 바인딩하고 인증이 포함된 신뢰할 수 있는 터널이나 리버스 프록시 뒤에 배치하십시오. DOL 및 SAM.gov API 키는 서버 측 .env에 유지됩니다.

도구

• ask_government_data: 일반 영어 질문을 올바른 데이터베이스로 라우팅하고 WHD 집행, OSHA 검사, DOL 외국인 노동/LCA 공개 또는 SAM.gov 기회에 대해 쿼리를 실행합니다.

• whd_enforcement_query: limit, offset, fields, sort, sort_by 및 filter_object를 사용하여 WHD/enforcement를 쿼리합니다.

• whd_enforcement_case: 숫자 case_id를 조회합니다.

• whd_enforcement_metadata: 선택적 search, category 및 limit과 함께 전체 메타데이터 행을 반환합니다.

• whd_enforcement_fields: 쿼리 작성을 위한 간결한 필드 설명을 반환합니다.

• dol_datasets_search: 공개 DOL 데이터셋 카탈로그를 검색합니다.

• lca_disclosure_files: 회계 연도 분기에 대한 공식 DOL OFLC LCA 공개 및 레코드 레이아웃 URL을 반환합니다.

• lca_disclosure_fields: DOL LCA 공개 XLSX 파일에서 필드 이름을 읽습니다.

• lca_search: 고용주, 작업장, 직함, SOC, NAICS, 상태, 비자 등급, 임금 및 날짜별로 DOL OFLC LCA 공개 데이터를 검색합니다.

• lca_employer_profile: 인증 수, 임금 통계, 주요 직함, SOC 코드, 작업장, H-1B 의존성 및 고의적 위반자 플래그가 포함된 DOL LCA 전용 고용주 프로필을 작성합니다.

• foreign_labor_files: LCA, PERM, H-2A, H-2B 또는 CW에 대한 공식 DOL OFLC 공개 통합 문서, 레코드 레이아웃 및 보조 파일 URL을 찾습니다.

• foreign_labor_fields: 공식 DOL 외국인 노동 공개 XLSX 파일에서 필드 이름을 읽습니다.

• foreign_labor_search: DOL OFLC 외국인 노동 공개 통합 문서를 스트림 검색하고 LCA, PERM, H-2A, H-2B 및 CW-1 전반에 걸쳐 통합된 스키마를 반환합니다.

• osha_fields: 공식 DOL OSHA inspection 또는 violation 데이터셋에 대한 메타데이터를 반환합니다.

• osha_inspection_search: 사업장, 주, 도시, NAICS, 검사 유형, 안전/보건 및 개시 날짜 범위별로 OSHA 검사를 검색합니다. 선택적으로 삭제되지 않은 위반/인용 기록을 결합합니다.

• osha_inspection_detail: activity_nr로 하나의 OSHA 검사를 조회하고 선택적으로 위반/인용 기록을 결합합니다.

• sam_opportunities_search: 제목 키워드, NAICS 코드, 조달 유형, 세트어사이드(set-aside) 코드, 수행 장소 주 및 게시 날짜 범위별로 공식 SAM.gov 계약 기회를 검색합니다.

• sam_opportunity_detail: noticeId로 하나의 SAM.gov 기회를 조회합니다.

• sam_reference: 일반적인 SAM.gov 조달 유형 및 세트어사이드 코드를 반환합니다.

• places_search: 지역 내 비즈니스에 대해 Google Places (New) 텍스트 검색을 수행합니다. 소스 추적을 위한 googleMapsUrl이 포함된 중복 제거된 결과를 반환합니다. 레스토랑 조사 에이전트를 위한 라운드별 검색 기본 요소로 설계되었습니다.

• places_detail: Place ID로 하나의 Google 장소를 조회합니다. 영업 시간, 배달/매장 식사 플래그 및 (선택적으로) editorialSummary와 리뷰를 반환합니다.

LCA 도구는 DOL 성과 데이터 페이지의 공식 OFLC 공개 통합 문서를 사용합니다. 통합 문서가 클 수 있으므로 다운로드된 파일은 .cache/dol-lca/ 아래에 캐시됩니다. 이미 다운로드된 공식 LCA 공개 XLSX 파일을 localFile로 전달할 수도 있습니다.

LCA 프로필은 DOL 전용입니다. 별도의 USCIS 데이터 소스가 추가되지 않는 한 USCIS H-1B 청원 승인 및 거부율은 포함되지 않습니다.

외국인 노동 도구는 DOL 성과 데이터 페이지를 읽어 현재 공개 링크를 찾은 다음 XLSX 파일을 행 단위로 스트림 파싱합니다. 지원되는 프로그램은 LCA, PERM, H-2A, H-2B 및 CW이며, 지원되는 통합 파서 회계 연도는 2020년부터 2030년까지입니다. 이미 다운로드된 공식 통합 문서를 가리키려면 localFile을 사용하십시오.

OSHA 도구는 공식 DOL 오픈 데이터 API 데이터셋 OSHA/inspection 및 OSHA/violation을 사용합니다. 위반 행은 activity_nr에 의해 검사와 결합되며, delete_flag가 X인 행은 결합된 출력에서 제외됩니다.

SAM.gov 도구는 https://api.sam.gov/opportunities/v2/search의 공식 Opportunities API를 사용합니다. 실시간 검색에는 SAM_GOV_API_KEY 또는 SAM_API_KEY가 필요하며, 드라이 런 검색은 SAM.gov를 호출하지 않고 샘플 기회를 반환합니다. API는 게시 날짜 범위를 요구하므로 postedDaysAgo는 MM/dd/yyyy 형식의 postedFrom 및 postedTo로 변환됩니다.

예시

체불 임금이 있는 아이오와(Iowa) 기록 필터링:

{
  "limit": 10,
  "fields": ["case_id", "trade_nm", "st_cd", "bw_atp_amt", "findings_end_date"],
  "sort": "desc",
  "sort_by": "bw_atp_amt",
  "filter_object": {
    "and": [
      { "field": "st_cd", "operator": "eq", "value": "IA" },
      { "field": "bw_atp_amt", "operator": "gt", "value": 0 }
    ]
  }
}

필드 메타데이터 검색:

{
  "search": "backwage",
  "limit": 20
}

LCA 공개 데이터 검색:

{
  "fiscalYear": 2026,
  "quarter": 1,
  "employerName": "Google",
  "state": "CA",
  "jobTitle": "software",
  "maxResults": 25
}

DOL LCA 고용주 프로필 작성:

{
  "fiscalYear": 2026,
  "quarter": 1,
  "employerName": "Google",
  "searchMode": "contains",
  "maxResults": 5000
}

통합 DOL 외국인 노동 공개 검색:

{
  "visaProgram": "H-2A",
  "fiscalYear": 2026,
  "fiscalQuarter": "Q1",
  "worksiteState": "IA",
  "caseStatus": "Certified",
  "maxItems": 100
}

PERM 인증 검색:

{
  "visaProgram": "PERM",
  "fiscalYear": 2026,
  "fiscalQuarter": "Q1",
  "employerName": "Intel",
  "minAnnualWage": 150000,
  "maxItems": 500
}

인용 기록이 결합된 OSHA 검사 검색:

{
  "companyName": "Walmart",
  "state": "TX",
  "includeViolations": true,
  "maxResults": 25
}

사망/재난 건설 검사 검색:

{
  "state": "TX",
  "naicsCode": "23",
  "inspectionType": "A",
  "dateFrom": "2024-01-01",
  "includeViolations": true,
  "maxResults": 100
}

드라이 런 모드에서 SAM.gov 기회 검색:

{
  "keywords": "cybersecurity",
  "naicsCodes": ["541512"],
  "setAsideType": "SBA",
  "postedDaysAgo": 30,
  "maxResults": 10,
  "dryRun": true
}

SAM 키 추가 후 실시간 SAM.gov 기회 검색:

{
  "keywords": "software development",
  "naicsCodes": ["541512", "541511"],
  "procurementTypes": ["o", "k", "r"],
  "state": "VA",
  "postedDaysAgo": 30,
  "maxResults": 100,
  "dryRun": false
}

일반 영어 라우팅 질문하기:

{
  "question": "Show OSHA inspections and citations for Walmart in TX",
  "maxResults": 10
}

드라이 런 모드에서 SAM.gov 기회 요청하기:

{
  "question": "Find cybersecurity solicitations NAICS 541512 in Virginia",
  "maxResults": 10,
  "dryRun": true
}

DOL 외국인 노동 공개 기록 요청하기:

{
  "question": "H-2A certified farm jobs in IA SOC 45-2092 over $20 hourly",
  "maxResults": 10
}

도시 내 레스토랑에 대한 Google Places 검색:

{
  "query": "restaurants in Hillsdale, MI",
  "includedTypes": ["restaurant"],
  "maxResults": 30,
  "excludeClosed": true
}

Place ID로 하나의 Google 장소 조회:

{
  "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4",
  "includeAtmosphere": false
}