BLS OEWS

bls-oews-mcp

免费的开源 MCP 服务，提供美国劳工统计局（BLS）职业就业与工资统计（OEWS）市场工资数据，适用于 IGCE 制定、价格分析和劳动力市场研究。

概览、演示视频和托管设置：https://1102tools.com/mcp/bls-oews

无需 API 密钥，也没有每日调用上限。软件包内置当前的 OEWS 版本（2025 年 5 月估算值，由 BLS 于 2026 年 5 月 15 日发布），这是根据 BLS 发布的纯文本文件构建的只读数据库，因此所有答案都在本地生成，每条结果都会注明 BLS 版本、发布日期、检索日期和源文件。请参阅本地或托管。

当 BLS 未发布某项工资指标的数据时，答案会保留解释原因的 BLS 脚注，并建议使用已发布的小时或年度数据作为替代。工资数据被封顶时，会保留 BLS 发布的下限；服务不会编造精确工资，也不会将仅按小时提供的数据折算成年薪。

发布前会运行回归测试，并根据 BLS 源数据验证贴近实际承包工作的工资问题。请参阅 testing.md。

本地或托管

本地（桌面端）	Claude（托管）	ChatGPT（托管）
本地设置	安装	安装

• 本地会在你的电脑上运行，可在 Claude 或 ChatGPT 桌面应用或其他 AI 应用中使用。答案来自内置的 BLS 数据库，不会调用政府 API，也没有请求次数限制。它不会自动更新，因此可以让 AI 帮你更新。你无需手动设置：把此页面的链接发给 AI，请它帮你设置或指导你完成设置。
• 托管始终保持最新，无需设置或密钥，可在任何地方的 Claude 或 ChatGPT 中使用。

比较本地版和托管版 · 匹配提示词

功能

通过 8 个 MCP 工具，根据内置版本回答 OEWS 相关问题：

核心

• get_wage_data - 按 SOC 代码查询某个职业的工资统计数据（全国、州或都市区）
• compare_metros - 比较某个职业在多个都市区的工资
• compare_occupations - 比较某个地区多个职业的工资

工作流

• igce_wage_benchmark - 提供工资基准和含附加成本的费率估算，适用于 IGCE 制定
• detect_latest_year - 报告内置 OEWS 数据年份和版本

参考

• list_common_soc_codes - 联邦 IT／专业服务的 SOC 代码对照
• list_common_metros - 都市区 MSA 代码
• get_data_status - 内置版本、其 BLS 源文件的 SHA-256 和发布日期，以及检索日期

数据源

内置数据库由 scripts/build_oews_db.py 根据 download.bls.gov/pub/time.series/oe/ 上的 BLS OEWS 纯文本文件构建，涵盖全国、州、都市区和非都市区，以及全国行业对所有职业的估算数据和全部 17 种 OEWS 数据类型，包括相对标准误差。 data/manifest.json 记录了每个源文件的 URL、大小、SHA-256 和 BLS 发布日期。系统每周检查一次，报告 BLS 是否发布了新版本；新版本将作为新的软件包版本发布。

BLS.gov 无法为从 BLS.gov 检索数据后由这些数据得出的数据或分析结果背书。

安装

uvx --refresh-package bls-oews-mcp --from bls-oews-mcp bls-oews-mcp

配置

使用以下配置作为服务定义，并根据兼容的 MCP 客户端调整其位置。有关使用此数据源的实际请求，请参阅提示词库。

{
  "mcpServers": {
    "bls-oews": {
      "command": "uvx",
      "args": ["--refresh-package", "bls-oews-mcp", "--from", "bls-oews-mcp", "bls-oews-mcp"]
    }
  }
}

--refresh-package 标志会让 uv 在客户端每次启动服务时检查 PyPI 是否有更新版本，因此修复和新的 OEWS 发布版会自动到达；如果不加此标志，uv 会继续提供首次缓存的版本。它会在启动时增加一点网络耗时，因此如果你的平台设置了较短的 MCP 启动超时，请调高该超时时间。

首次使用时，服务会将随附的数据库（约 50 MB）解压到用户缓存目录；如需将其放到其他位置，请设置 BLS_OEWS_DATA_DIR。

重启客户端后，工具就会显示。

示例提示词

• “Software Developers（SOC 151252）的全国薪资中位数是多少？”
• “比较 DC、Seattle 和 Baltimore 的 Systems Analyst 薪资。”
• “以 DC 都会区为基准，为 Program Manager、Software Developer 和 Help Desk 制定 IGCE 薪资基准，并使用 2.0x 负担系数。”
• “Senior Software Developer 的时薪为 195 美元是否合理？请展示 BLS 市场数据。”
• “Virginia 的 Information Security Analysts 薪资与全国水平相比如何？”

重要提示：基本工资，而非含负担费率

BLS OEWS 数据代表雇主申报的基本工资（不含福利、间接费用、G&A 或利润）。要估算 IGCE 的全负担时薪，请应用负担乘数：

• 1.5x-1.7x：精简型承包商
• 1.8x-2.2x：中档专业服务
• 2.0x-2.5x：承担安全许可管理开销的大型承包商
• 2.5x-3.0x：高间接费用（SCIF、部署）

igce_wage_benchmark 工具会自动应用乘数。OEWS 薪资是该发布版参考月份（5 月）的估算值，因此请根据履约期进行调整；工具的 wage_period 和 _escalation_note 会说明对应月份。

数据年份

OEWS 通常会延迟约一年发布。服务使用随附的 2025 年发布版作答（2025 年 5 月估算值，于 2026 年 5 月 15 日发布）；请求其他年份会返回明确错误，并指向 bls.gov/oes/tables.htm 上的历史表格。通常使用时请省略年份参数，并调用 detect_latest_year 或 get_data_status 查看随附的发布版。

配套工具

可与 gsa-calc-mcp（GSA CALC+ 最高限价）配合使用，完成全面的定价分析。BLS 提供市场支付水平；CALC+ 提供 GSA 承包商收费水平。二者共同构成 IGCE 定价工具包。

许可证

MIT