DOL WHD MCP

Servidor MCP en TypeScript para datos de cumplimiento de WHD del Departamento de Trabajo, divulgación de LCA de OFLC, inspecciones de OSHA y oportunidades de contrato de SAM.gov.

Configuración

npm install
npm run build

Cree un archivo .env local:

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

El servidor también acepta DOL_API_KEY, SAM_GOV_API_KEY o SAM_API_KEY desde el entorno del proceso. Las herramientas de SAM.gov pueden ejecutarse en modo de prueba (dry-run) sin una clave de SAM. Las respuestas de las herramientas redactan las URL de solicitud y nunca devuelven claves.

Ejecutar localmente a través de Stdio

npm start

Ejemplo de configuración de cliente MCP:

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

Ejecutar remotamente a través de HTTP

Compile primero, luego inicie el punto final HTTP MCP Streamable:

npm run build
npm run start:http

Valores predeterminados:

• Punto final MCP: http://127.0.0.1:8787/mcp

• Verificación de estado: http://127.0.0.1:8787/health

• Transporte: MCP Streamable HTTP, sin estado por solicitud.

Controles de entorno remoto:

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

Si se establece DOL_MCP_AUTH_TOKEN, los clientes MCP deben enviar:

Authorization: Bearer change-this-before-exposing

o:

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

Mantenga el host predeterminado para acceso solo local. Para hacerlo accesible desde otra máquina, vincúlelo a una interfaz accesible como 0.0.0.0 y colóquelo detrás de un túnel confiable o proxy inverso con autenticación. Las claves de API de DOL y SAM.gov permanecen en el lado del servidor en .env.

Herramientas

• ask_government_data: Dirige una pregunta en inglés sencillo a la base de datos correcta y ejecuta la consulta contra el cumplimiento de WHD, inspecciones de OSHA, divulgaciones de trabajo extranjero/LCA del DOL u oportunidades de SAM.gov.

• whd_enforcement_query: Consulta WHD/enforcement con limit, offset, fields, sort, sort_by y filter_object.

• whd_enforcement_case: Busca un case_id numérico.

• whd_enforcement_metadata: Devuelve filas de metadatos completas, con search, category y limit opcionales.

• whd_enforcement_fields: Devuelve descripciones concisas de campos para la creación de consultas.

• dol_datasets_search: Busca en el catálogo público de conjuntos de datos del DOL.

• lca_disclosure_files: Devuelve las URL oficiales de divulgación de LCA de OFLC del DOL y el diseño de registros para un trimestre del año fiscal.

• lca_disclosure_fields: Lee nombres de campos de un archivo XLSX de divulgación de LCA del DOL.

• lca_search: Busca en los datos de divulgación de LCA de OFLC del DOL por empleador, lugar de trabajo, título, SOC, NAICS, estado, clase de visa, salario y fechas.

• lca_employer_profile: Crea un perfil de empleador solo de LCA del DOL con recuentos de certificación, estadísticas salariales, títulos de trabajo principales, códigos SOC, lugares de trabajo, dependientes de H-1B y banderas de infractor intencional.

• foreign_labor_files: Descubre las URL oficiales del libro de trabajo de divulgación de OFLC del DOL, diseño de registros y archivos auxiliares para LCA, PERM, H-2A, H-2B o CW.

• foreign_labor_fields: Lee nombres de campos de un archivo XLSX oficial de divulgación de trabajo extranjero del DOL.

• foreign_labor_search: Busca en los libros de trabajo de divulgación de trabajo extranjero de OFLC del DOL y devuelve un esquema unificado en LCA, PERM, H-2A, H-2B y CW-1.

• osha_fields: Devuelve metadatos para el conjunto de datos oficial de inspección o violación de OSHA del DOL.

• osha_inspection_search: Busca inspecciones de OSHA por establecimiento, estado, ciudad, NAICS, tipo de inspección, seguridad/salud y rango de fechas de apertura. Opcionalmente, une registros de violación/citación no eliminados.

• osha_inspection_detail: Busca una inspección de OSHA por activity_nr y opcionalmente une registros de violación/citación.

• sam_opportunities_search: Busca oportunidades de contrato oficiales de SAM.gov por palabras clave de título, códigos NAICS, tipos de adquisición, código de reserva, estado del lugar de ejecución y rango de fechas de publicación.

• sam_opportunity_detail: Busca una oportunidad de SAM.gov por noticeId.

• sam_reference: Devuelve códigos comunes de tipo de adquisición y reserva de SAM.gov.

• places_search: Busca en Google Places (New) Text Search empresas en un área. Devuelve resultados deduplicados con googleMapsUrl para el seguimiento de la fuente. Diseñado como una primitiva de recuperación por ronda para el Agente de Investigación de Restaurantes.

• places_detail: Busca un lugar de Google por ID de lugar. Devuelve horarios, banderas de entrega/comedor y (opcionalmente) editorialSummary y reseñas.

Las herramientas de LCA utilizan libros de trabajo de divulgación oficiales de OFLC de la página de Datos de Rendimiento del DOL. Los libros de trabajo pueden ser grandes, por lo que los archivos descargados se almacenan en caché en .cache/dol-lca/. También puede pasar localFile con un archivo XLSX de divulgación de LCA oficial ya descargado.

El perfil de LCA es solo del DOL. Las tasas de aprobación y denegación de peticiones H-1B de USCIS no se incluyen a menos que se agregue una fuente de datos de USCIS separada.

Las herramientas de trabajo extranjero leen la página de Datos de Rendimiento del DOL para descubrir enlaces de divulgación actuales, luego analizan los archivos XLSX fila por fila. Los programas admitidos son LCA, PERM, H-2A, H-2B y CW; los años fiscales del analizador unificado admitidos son de 2020 a 2030. Use localFile para apuntar a un libro de trabajo oficial ya descargado.

Las herramientas de OSHA utilizan los conjuntos de datos oficiales de la API de Datos Abiertos del DOL OSHA/inspection y OSHA/violation. Las filas de violación se unen a las inspecciones por activity_nr; las filas con delete_flag igual a X se excluyen de la salida unida.

Las herramientas de SAM.gov utilizan la API de Oportunidades oficial en https://api.sam.gov/opportunities/v2/search. Las búsquedas en vivo requieren SAM_GOV_API_KEY o SAM_API_KEY; las búsquedas de prueba devuelven oportunidades de muestra sin llamar a SAM.gov. La API requiere límites de fecha de publicación, por lo que postedDaysAgo se convierte a postedFrom y postedTo en formato MM/dd/yyyy.

Ejemplos

Filtrar registros de Iowa con salarios atrasados:

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

Buscar metadatos de campo:

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

Buscar datos de divulgación de LCA:

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

Crear un perfil de empleador de LCA del DOL:

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

Buscar divulgaciones unificadas de trabajo extranjero del DOL:

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

Buscar certificaciones PERM:

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

Buscar inspecciones de OSHA con citaciones unidas:

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

Buscar inspecciones de construcción por fatalidad/catástrofe:

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

Buscar oportunidades de SAM.gov en modo de prueba:

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

Buscar oportunidades de SAM.gov en vivo después de agregar una clave SAM:

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

Hacer una pregunta en inglés sencillo:

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

Solicitar oportunidades de SAM.gov en modo de prueba:

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

Solicitar registros de divulgación de trabajo extranjero del DOL:

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

Buscar en Google Places restaurantes en una ciudad:

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

Buscar un lugar de Google por ID de lugar:

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