Employment Data MCP

面向 Hermes 的只读 FastMCP 服务，提供四个工具：

• get_bls_employment：BLS 非农就业总人数、月新增、失业率及实际发布日期；

• get_adp_employment：ADP 私营就业总人数、月新增及实际发布日期；

• get_economic_calendar：指定日期的实际值、预期值、前值和 surprise；

• get_employment_release_summary：指定发布日期的 ADP、非农和失业率摘要。

Docker 部署（推荐）

cp .env.example .env
# 编辑 .env，至少设置 BLS_API_KEY 和 FRED_API_KEY
docker compose up -d --build
docker compose logs -f employment-data-mcp

默认 MCP 地址是 http://127.0.0.1:8010/mcp，仅监听宿主机回环地址， 不会直接暴露到公网。

如果代理运行在 Docker 宿主机的 11111 端口，容器内不能使用 127.0.0.1:11111，请配置：

FINANCE_PROXY_URL=http://host.docker.internal:11111

compose.yaml 已配置 Linux 所需的 host-gateway。不需要代理时将该变量留空。

Related MCP server: EODHD MCP Server

Hermes 配置

在 Hermes 的 config.yaml 中加入：

mcp_servers:
  us_employment:
    url: "http://127.0.0.1:8010/mcp"
    enabled: true
    timeout: 120
    supports_parallel_tool_calls: false
    tools:
      include:
        - get_bls_employment
        - get_adp_employment
        - get_economic_calendar
        - get_employment_release_summary

然后执行 hermes mcp test us_employment 验证连接；已经启动的 Hermes 会话中可用 /reload-mcp 重新加载。若 Hermes 自身也在容器中，127.0.0.1 指向 Hermes 容器，应把两个服务接入同一 Docker 网络，并将 URL 改为 http://employment-data-mcp:8010/mcp。

不使用 Docker

服务器已有 Python 3.11+ 和 uv 时：

uv sync --frozen
uv run employment-data-mcp

依赖安装在本项目的 .venv，不污染 Hermes 的 Python 环境。修改监听配置可设置 MCP_HOST、MCP_PORT 和 MCP_PATH。

开发验证

uv sync --extra dev
uv run pytest

API key 和代理地址只放在 .env，不要提交到仓库。经济日历预期值来自第三方日历源， 返回结果中会保留 source；BLS 与 ADP 历史序列可能随官方修订发生变化。