DOL WHD MCP

用于劳工部 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 密钥的情况下以试运行模式运行。工具响应会屏蔽请求 URL，且绝不会返回密钥。

通过 Stdio 在本地运行

npm start

示例 MCP 客户端配置：

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

通过 HTTP 远程运行

先构建，然后启动可流式传输的 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 可流式传输 HTTP，每个请求无状态。

远程环境配置项：

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：构建仅限 DOL LCA 的雇主档案，包含认证计数、工资统计、热门职位、SOC 代码、工作地点、H-1B 依赖和故意违规标记。

• 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 代码、采购类型、预留代码、履约地州和发布日期范围搜索官方 SAM.gov 合同机会。

• sam_opportunity_detail：按 noticeId 查找一项 SAM.gov 机会。

• sam_reference：返回常见的 SAM.gov 采购类型和预留代码。

• places_search：搜索 Google Places (New) 文本搜索以查找区域内的企业。返回去重后的结果，并带有用于来源追踪的 googleMapsUrl。设计为餐厅研究代理的每轮检索原语。

• places_detail：按地点 ID 查找一个 Google 地点。返回营业时间、外卖/堂食标记以及（可选的）编辑摘要和评论。

LCA 工具使用来自 DOL 绩效数据页面的官方 OFLC 披露工作簿。工作簿可能很大，因此下载的文件会缓存在 .cache/dol-lca/ 下。您还可以传递 localFile 参数，使用已下载的官方 LCA 披露 XLSX 文件。

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 处的官方机会 API。实时搜索需要 SAM_GOV_API_KEY 或 SAM_API_KEY；试运行搜索返回示例机会而不调用 SAM.gov。API 需要发布日期范围，因此 postedDaysAgo 会转换为 MM/dd/yyyy 格式的 postedFrom 和 postedTo。

示例

筛选爱荷华州有补发工资的记录：

{
  "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 地点：

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

按地点 ID 查找一个 Google 地点：

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