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キーなしでドライランモードで実行できます。ツールの応答はリクエスト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、リクエストごとにステートレス。

リモート環境のノブ：

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 で1つのOSHA査察を検索し、オプションで違反/引用レコードを結合します。

• sam_opportunities_search: タイトルのキーワード、NAICSコード、調達タイプ、セットアサイドコード、履行場所の州、および投稿日の範囲で公式SAM.govの契約機会を検索します。

• sam_opportunity_detail: noticeId で1つのSAM.govの機会を検索します。

• sam_reference: 一般的なSAM.govの調達タイプおよびセットアサイドコードを返します。

• places_search: エリア内のビジネスについてGoogle Places (New) テキスト検索を実行します。ソース追跡用の googleMapsUrl を含む重複排除された結果を返します。レストラン調査エージェント用のラウンドごとの取得プリミティブとして設計されています。

• places_detail: Place IDで1つのGoogleプレイスを検索します。営業時間、デリバリー/イートインフラグ、および（オプションで）editorialSummaryとレビューを返します。

LCAツールは、DOLパフォーマンスデータページの公式OFLC開示ワークブックを使用します。ワークブックは大きくなる可能性があるため、ダウンロードされたファイルは .cache/dol-lca/ にキャッシュされます。すでにダウンロード済みの公式LCA開示XLSXファイルを localFile として渡すこともできます。

LCAプロファイルはDOL専用です。USCISのH-1B請願承認率および拒否率は、別のUSCISデータソースが追加されない限り含まれません。

外国人労働者ツールは、DOLパフォーマンスデータページを読み取って現在の開示リンクを発見し、XLSXファイルを1行ずつストリーム解析します。サポートされているプログラムは 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 に変換されます。

例

未払い賃金のあるアイオワ州の記録をフィルタリング：

{
  "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で1つのGoogleプレイスを検索する：

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