DOL WHD MCP

TypeScript-MCP-Server für Daten zu WHD-Durchsetzungen des Arbeitsministeriums, OFLC-LCA-Offenlegungen, OSHA-Inspektionen und SAM.gov-Auftragsmöglichkeiten.

Einrichtung

npm install
npm run build

Erstellen Sie eine lokale .env-Datei:

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

Der Server akzeptiert auch DOL_API_KEY, SAM_GOV_API_KEY oder SAM_API_KEY aus der Prozessumgebung. SAM.gov-Tools können im Trockenlaufmodus (Dry-Run) ohne SAM-Schlüssel ausgeführt werden. Tool-Antworten schwärzen Anfrage-URLs und geben niemals Schlüssel zurück.

Lokal über Stdio ausführen

npm start

Beispiel für eine MCP-Client-Konfiguration:

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

Remote über HTTP ausführen

Zuerst bauen, dann den Streamable HTTP MCP-Endpunkt starten:

npm run build
npm run start:http

Standardwerte:

• MCP-Endpunkt: http://127.0.0.1:8787/mcp

• Gesundheitsprüfung: http://127.0.0.1:8787/health

• Transport: MCP Streamable HTTP, zustandslos pro Anfrage.

Remote-Umgebungseinstellungen:

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

Wenn DOL_MCP_AUTH_TOKEN gesetzt ist, müssen MCP-Clients entweder Folgendes senden:

Authorization: Bearer change-this-before-exposing

oder:

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

Behalten Sie den Standard-Host für den lokalen Zugriff bei. Um ihn von einem anderen Computer aus erreichbar zu machen, binden Sie ihn an eine erreichbare Schnittstelle wie 0.0.0.0 und platzieren Sie ihn hinter einem vertrauenswürdigen Tunnel oder Reverse-Proxy mit Authentifizierung. Die DOL- und SAM.gov-API-Schlüssel verbleiben serverseitig in der .env.

Tools

• ask_government_data: Leitet eine Frage in einfachem Englisch an die richtige Datenbank weiter und führt die Abfrage gegen WHD-Durchsetzungen, OSHA-Inspektionen, DOL-Auslandsarbeits-/LCA-Offenlegungen oder SAM.gov-Möglichkeiten aus.

• whd_enforcement_query: Fragt WHD/enforcement mit limit, offset, fields, sort, sort_by und filter_object ab.

• whd_enforcement_case: Sucht nach einer numerischen case_id.

• whd_enforcement_metadata: Gibt vollständige Metadatenzeilen zurück, mit optionalem search, category und limit.

• whd_enforcement_fields: Gibt prägnante Feldbeschreibungen für die Abfrageerstellung zurück.

• dol_datasets_search: Durchsucht den öffentlichen DOL-Datensatzkatalog.

• lca_disclosure_files: Gibt offizielle DOL OFLC LCA-Offenlegungs- und Datensatz-Layout-URLs für ein Geschäftsjahresquartal zurück.

• lca_disclosure_fields: Liest Feldnamen aus einer DOL LCA-Offenlegungs-XLSX-Datei.

• lca_search: Durchsucht DOL OFLC LCA-Offenlegungsdaten nach Arbeitgeber, Arbeitsort, Titel, SOC, NAICS, Status, Visaklasse, Lohn und Daten.

• lca_employer_profile: Erstellt ein DOL LCA-spezifisches Arbeitgeberprofil mit Zertifizierungsanzahlen, Lohnstatistiken, Top-Jobtiteln, SOC-Codes, Arbeitsorten, H-1B-Abhängigkeits- und vorsätzlichen Verletzer-Flags.

• foreign_labor_files: Ermittelt offizielle DOL OFLC-Offenlegungs-Arbeitsmappen, Datensatz-Layouts und Hilfsdatei-URLs für LCA, PERM, H-2A, H-2B oder CW.

• foreign_labor_fields: Liest Feldnamen aus einer offiziellen DOL-Auslandsarbeits-Offenlegungs-XLSX-Datei.

• foreign_labor_search: Durchsucht DOL OFLC-Auslandsarbeits-Offenlegungs-Arbeitsmappen im Stream und gibt ein einheitliches Schema über LCA, PERM, H-2A, H-2B und CW-1 zurück.

• osha_fields: Gibt Metadaten für den offiziellen DOL OSHA-Datensatz inspection oder violation zurück.

• osha_inspection_search: Durchsucht OSHA-Inspektionen nach Einrichtung, Bundesstaat, Stadt, NAICS, Inspektionsart, Sicherheit/Gesundheit und Zeitraum des Eröffnungsdatums. Verknüpft optional nicht gelöschte Verletzungs-/Zitierungsdatensätze.

• osha_inspection_detail: Sucht eine OSHA-Inspektion nach activity_nr und verknüpft optional Verletzungs-/Zitierungsdatensätze.

• sam_opportunities_search: Durchsucht offizielle SAM.gov-Auftragsmöglichkeiten nach Titel-Schlüsselwörtern, NAICS-Codes, Beschaffungsarten, Set-Aside-Code, Bundesstaat des Leistungsortes und Zeitraum des Veröffentlichungsdatums.

• sam_opportunity_detail: Sucht eine SAM.gov-Möglichkeit nach noticeId.

• sam_reference: Gibt gängige SAM.gov-Beschaffungsarten und Set-Aside-Codes zurück.

• places_search: Durchsucht Google Places (Neu) Textsuche nach Unternehmen in einem Gebiet. Gibt deduplizierte Ergebnisse mit googleMapsUrl zur Quellenverfolgung zurück. Konzipiert als Abruf-Primitiv pro Runde für den Restaurant-Research-Agenten.

• places_detail: Sucht einen Google-Ort nach Place ID. Gibt Öffnungszeiten, Liefer-/Dine-in-Flags und (optional) editorialSummary und Bewertungen zurück.

LCA-Tools verwenden offizielle OFLC-Offenlegungs-Arbeitsmappen von der DOL Performance Data-Seite. Die Arbeitsmappen können groß sein, daher werden heruntergeladene Dateien unter .cache/dol-lca/ zwischengespeichert. Sie können auch localFile mit einer bereits heruntergeladenen offiziellen LCA-Offenlegungs-XLSX-Datei übergeben.

Das LCA-Profil ist nur für DOL-Daten. USCIS H-1B-Antragsgenehmigungs- und Ablehnungsraten sind nicht enthalten, es sei denn, eine separate USCIS-Datenquelle wird hinzugefügt.

Auslandsarbeits-Tools lesen die DOL Performance Data-Seite, um aktuelle Offenlegungslinks zu entdecken, und parsen dann XLSX-Dateien zeilenweise im Stream. Unterstützte Programme sind LCA, PERM, H-2A, H-2B und CW; unterstützte Geschäftsjahre für den einheitlichen Parser sind 2020 bis 2030. Verwenden Sie localFile, um auf eine bereits heruntergeladene offizielle Arbeitsmappe zu verweisen.

OSHA-Tools verwenden die offiziellen DOL Open Data API-Datensätze OSHA/inspection und OSHA/violation. Verletzungszeilen werden mit Inspektionen über activity_nr verknüpft; Zeilen mit delete_flag gleich X werden von der verknüpften Ausgabe ausgeschlossen.

SAM.gov-Tools verwenden die offizielle Opportunities API unter https://api.sam.gov/opportunities/v2/search. Live-Suchen erfordern SAM_GOV_API_KEY oder SAM_API_KEY; Trockenlauf-Suchen geben Beispielmöglichkeiten zurück, ohne SAM.gov aufzurufen. Die API erfordert Grenzen für das Veröffentlichungsdatum, daher wird postedDaysAgo in postedFrom und postedTo im Format MM/dd/yyyy konvertiert.

Beispiele

Iowa-Datensätze mit Lohnnachzahlungen filtern:

{
  "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 }
    ]
  }
}

Feldmetadaten durchsuchen:

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

LCA-Offenlegungsdaten durchsuchen:

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

Ein DOL LCA-Arbeitgeberprofil erstellen:

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

Einheitliche DOL-Auslandsarbeits-Offenlegungen durchsuchen:

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

PERM-Zertifizierungen durchsuchen:

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

OSHA-Inspektionen mit verknüpften Zitierungen durchsuchen:

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

Bauinspektionen bei Todesfällen/Katastrophen durchsuchen:

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

SAM.gov-Möglichkeiten im Trockenlaufmodus durchsuchen:

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

Live SAM.gov-Möglichkeiten nach Hinzufügen eines SAM-Schlüssels durchsuchen:

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

Eine weitergeleitete Frage in einfachem Englisch stellen:

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

Nach SAM.gov-Möglichkeiten im Trockenlaufmodus fragen:

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

Nach DOL-Auslandsarbeits-Offenlegungsdatensätzen fragen:

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

Google Places nach Restaurants in einer Stadt durchsuchen:

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

Einen Google-Ort nach Place ID suchen:

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