GSA Per Diem

gsa-perdiem-mcp

GSA Per Diem Rates API 用の無料のオープンソース MCP サーバーです。連邦政府出張の宿泊費および M&IE 料金を、IGCE や出張費用の見積もりに活用できます。

概要、デモ動画、ホスト版の設定：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.data.gov キーが必要なのは、ライブ API へのリクエストのみです。自動更新されないため、AI に更新を依頼してください。手動でセットアップする必要はありません。このページのリンクを AI に渡し、セットアップを依頼するか、手順を案内してもらってください。
• ホスト版は常に最新の状態で、セットアップやキーが不要です。どこからでも Claude または ChatGPT で利用できます。

ローカル版とホスト版を比較 · 適合するプロンプト

できること

GSA の日当レートを、次の 7 つの MCP ツールとして提供します。

基本的な検索

• lookup_city_perdiem - 市区町村／州別のレートを検索します。市区町村が 1 つのレート地域に含まれる場合は、同梱の国勢調査データと郡データを使用し、それ以外の場合は GSA API を使用します（省略可能な county で 1 つの郡を選択できます）。
• 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 を指定すると、1 つを選択できます。市区町村のレート地域は、GSA の郡定義に基づき、Census 2020 の市区町村と郡の対応記録を使用して判定します。国勢調査に記載のない市区町村は GSA に問い合わせ、GSA でも認識されない場合は標準レートに割り当てず、unresolved とします。GSA が市区町村に複数のレート地域を列挙している場合、Census 2020 の市区町村と郡の対応記録によって、市区町村がそのうち 1 つだけに属すると判定できる場合に限り、候補を絞り込みます。すべての結果には 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" を指定してください。

同梱の国勢調査データと郡データでは判定できない市区町村名のリクエストや、同梱されていない年度の検索では、api.gsa.gov が呼び出され、api.data.gov のキーが必要です。キーは 1 時間あたり 1,000 件のリクエストに対応し、利用できるのはご本人のみです。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 に設定し、1 時間あたり 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 のワシントン DC の日当はいくらですか？」
• 「3 月にボストンで 4 泊する場合の旅費を見積もってください。」
• 「DC、ニューヨーク、サンフランシスコの日当を比較してください。」
• 「バージニア州にある NSA の日当対象地域をすべて教えてください。」
• 「92 ドルの区分の M&IE の食事内訳を表示してください。」
• 「旅費の見積もりを作成してください。シアトルへの出張が 3 回（各 4 泊）、DC への出張が 2 回（各 3 泊）です。」

重要：実際の価格ではなく、払い戻し上限です

日当率は、41 CFR 301-11 に基づく連邦政府の払い戻し上限です。実際のホテル料金ではありません。CONUS のみが対象です。外国以外の OCONUS 料金（アラスカ、ハワイ、準州）は DoD（DTMO）が、外国の料金は国務省が設定します。通常、宿泊税は含まれません。旅行初日と最終日の M&IE は 75% です。

関連ツール

完全な IGCE の作成には、bls-oews-mcp（賃金データ）および gsa-calc-mcp（上限率）と併せて使用してください。Per diem は旅費を扱い、BLS と CALC+ は人件費を扱います。

ライセンス

MIT

月または会計年度をまたぐ旅行。 各月の lodging_total を、該当する会計年度の料金で加算してください。M&IE は実際の旅行日数に基づいて一度だけ計算します。出発日と帰着日は 75%、その間の日は 100% です。月ごとの個別の mie_total や grand_total は加算しないでください。各見積もりは、それぞれ独自の出発日と帰着日を前提としているためです。たとえば、1 日あたり 92 ドルの M&IE 料金で 4 泊する場合、5 日間の旅行における M&IE は 414 ドルです。2 泊の見積もりを 2 件別々に作成すると、M&IE の合計は 460 ドルになります。