GSA Per Diem MCP

gsa-perdiem-mcp

GSA Per Diem Rates API 的免费开源 MCP 服务。为 IGCE 和差旅成本估算提供联邦差旅住宿及 M&IE 费率。

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

自 FY2021 起，按 ZIP、州和 M&IE 查询费率无需密钥或网络调用：这些查询直接使用软件包中附带的 GSA 已发布费率、ZIP 和 M&IE 文件。对于软件包中附带的财政年度，按城市查询、差旅估算以及与所提供的 county 进行比较也无需密钥或网络调用。如果城市名称查询未提供县，且附带的人口普查地点和 GSA 县数据足以确定费率区域，则会使用这些数据作答；其他城市名称和未附带年度的查询则会调用 GSA Per Diem API，并需要在 PERDIEM_API_KEY 中设置免费的 api.data.gov 密钥。托管版本的所有查询均无需密钥。请参阅本地或托管。

发布前会运行回归测试，并根据 GSA 已发布的费率核验符合实际情况的承包商差旅问题。请参阅 testing.md。

本地或托管

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

• 本地会在你的计算机上运行，可在 Claude 或 ChatGPT 桌面应用或其他 AI 应用中使用。你可以享有自己的完整速率限制，并且它只依赖政府服务。附带数据中的 ZIP、州、M&IE 以及城市加县查询无需密钥。只有实时 API 请求需要免费的 api.data.gov 密钥。它不会自动更新，因此请让 AI 帮你更新。你无需手动设置：将本页面链接发给 AI，请它帮你设置或指导你完成设置。
• 托管版本始终保持最新，无需设置或密钥，可随时在 Claude 或 ChatGPT 中使用。

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

功能

将 GSA 差旅津贴费率公开为 7 个 MCP 工具：

核心查询

• lookup_city_perdiem - 按城市和州查询费率；如果城市位于一个费率区域内，则使用随附的 Census 和县级数据，否则通过 GSA API 查询（可选的 county 用于指定一个县）
• lookup_zip_perdiem - 根据 GSA 的 ZIP 文件按 ZIP 编码查询费率（可选的 county）
• lookup_state_rates - 查询某个州的所有 NSA 费率和标准费率
• get_mie_breakdown - M&IE 分档表（餐费组成）
• get_data_status - 随附的财年、对应的 GSA 源文件，以及哪些工具会调用 API

工作流

• estimate_travel_cost - 计算行程差旅津贴（住宿费 + M&IE，首日和末日按 75% 计算）
• compare_locations - 比较多个城市的费率

绝不猜测费率区域。 GSA 按县或地方划分设定费率。当一个 ZIP 编码或城市跨越多个费率不同的区域时，结果会包含 status: "ambiguous" 并列出所有候选项；提供 county 可指定其中一个。城市所属的费率区域根据 GSA 的县级定义确定，并使用 Census 2020 地点到县的记录；Census 未列出的名称会交由 GSA 查询，而 GSA 也无法识别的名称会标记为 unresolved，不会默认采用标准费率。当 GSA 为某个城市列出多个费率区域时，仅当 Census 2020 地点到县的记录将该城市归入其中一个区域时，才会用于消除歧义。每个结果都会标明其 source：随附的 GSA 文件（含 SHA-256）或 API 端点。

随附数据。 src/gsa_perdiem_mcp/data/ 包含 FY2021 及之后的数据，由 scripts/build_snapshot.py 根据 GSA 差旅津贴文件页面和 Census 2020 地点／县代码文件生成。data/manifest.json 记录每个源的 URL 和 SHA-256。如果架构发生变化、GSA 费率文件与 ZIP 文件有任何不一致，或遇到尚未处理的地方名称表述，构建器都会失败。FY2020 和尚未随附的财年会使用 API。

API 密钥（仅用于实时 API 请求）

随附财年的 ZIP、州和 M&IE 请求无需密钥。对于随附财年，只要提供县名，lookup_city_perdiem、estimate_travel_cost 和 compare_locations 也无需密钥。例如，可查询马萨诸塞州萨福克县的波士顿，或在每个波士顿比较条目中加入 county: "Suffolk"。

随附的 Census 和县级数据无法确定的城市名称查询，以及对未随附财年的查询，都会调用 api.gsa.gov，并需要 1,000 次请求／小时的 api.data.gov 密钥，该密钥仅供你本人使用。未设置 PERDIEM_API_KEY 时，这些 API 请求会返回设置说明。对于随附财年，你也可以提供工作地点所在的县，无需设置密钥即可完成城市查询或差旅估算。

免费获取密钥（只需 30 秒）：

1. 前往 api.data.gov/signup
2. 输入姓名和电子邮件：无需审批，也无需等待
3. 从确认页面复制密钥
4. 将其粘贴到客户端配置中，设为 PERDIEM_API_KEY（见下文）

同一个密钥可用于所有由 api.data.gov 提供支持的 API（GSA Per Diem、NASA、 FEC、FCC 等）。

安装

uvx --refresh-package gsa-perdiem-mcp --from gsa-perdiem-mcp gsa-perdiem-mcp

配置

将以下配置用作服务器定义，并根据兼容的 MCP 客户端调整其放置位置。使用此来源处理实际请求时，请参阅提示词库。

使用你的密钥：

{
  "mcpServers": {
    "gsa-perdiem": {
      "command": "uvx",
      "args": ["--refresh-package", "gsa-perdiem-mcp", "--from", "gsa-perdiem-mcp", "gsa-perdiem-mcp"],
      "env": {
        "PERDIEM_API_KEY": "paste-your-api-data-gov-key-here",
        "FEDERAL_API_MIN_INTERVAL_SECONDS": "4"
      }
    }
  }
}

对于带密钥的请求，服务器将 FEDERAL_API_MIN_INTERVAL_SECONDS 的默认值设为 0.6，并将请求速率限制为每小时 950 次。上面的示例将其设为较慢的 4；两者都可以。使用同一个 api.data.gov 密钥的 Per Diem 和 Regulations.gov 进程会共用此限流机制。

无密钥配置（打包 ZIP、州、M&IE 以及城市加县的查询、估算和比较均可使用）：

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

--refresh-package 标志会指示 uv 在客户端每次启动服务器时检查 PyPI 是否有更新版本，以便自动获取修复；如果不使用该标志，uv 会继续提供首次缓存的版本。此操作会在启动时增加一点网络耗时，因此，如果你的平台设有较短的 MCP 启动超时时间，请将其调高。

重启客户端后，这些工具就会显示出来。

提示词示例

• “FY2026 华盛顿特区的每日津贴标准是多少？”
• “估算 3 月在波士顿住宿 4 晚的差旅费用。”
• “比较华盛顿特区、纽约和旧金山的每日津贴标准。”
• “弗吉尼亚州所有 NSA 每日津贴地点有哪些？”
• “展示 $92 档位的 M&IE 餐费明细。”
• “制定一份差旅费用估算：前往西雅图 3 次（每次 4 晚），前往华盛顿特区 2 次（每次 3 晚）。”

重要提示：最高报销标准，而非实际价格

每日津贴标准是依据 41 CFR 301-11 规定的联邦报销上限，并非实际酒店价格。仅适用于 CONUS。非外国 OCONUS 标准（阿拉斯加、夏威夷及属地）由 DoD (DTMO) 制定；外国标准由 State Department 制定。住宿税通常不包含在内。差旅首日和末日的 M&IE 按 75% 计算。

配套工具

与 bls-oews-mcp（工资数据）和 gsa-calc-mcp（上限标准）搭配使用，可完成完整的 IGCE 编制。每日津贴涵盖差旅部分；BLS 和 CALC+ 涵盖人工费用。

许可证

MIT

跨月或跨财政年度的行程。 按适用的财政年度费率，累加每个月的 lodging_total。根据实际差旅天数计算一次 M&IE：出发日和返程日按 75% 计算，中间日期按 100% 计算。不要累加各月单独的 mie_total 或 grand_total，因为每次估算都默认包含单独的出发日和返程日。例如，按每日 M&IE 费率 $92 计算，住宿 4 晚、差旅 5 天的 M&IE 费用为 $414；两次独立的 2 晚行程估算合计为 $460。