US Macro

US-Macro-MCP

AI アシスタントが米国のマクロ経済データにすっきりアクセスできる MCP サーバーです。Federal Reserve の FRED データベースを情報源とし、インフレ、雇用、成長、住宅、消費者行動、金利、金融ストレス、市場、連邦財政を網羅する58の指標を提供します。

アシスタントが FRED のシリーズ ID を知る必要も、計算をする必要もないように設計されています。cpi を指定すると、最新値、前回値、前年の値、および計算済みの変化率が返されます。

レジストリ公式リンク： https://pypi.org/project/us-macro-mcp/

変更履歴

日付	バージョン	コメント
2026-07-27	0.1.2	OS と Python のバージョン分類子、変更履歴を追加し、連絡先アドレスを GitHub noreply に変更しました。
2026-07-27	0.1.1	レジストリの所有権確認用に mcp-name マーカーを追加しました。公式 MCP レジストリに掲載された最初のバージョンです。
2026-07-27	0.1.0	初回リリース — 58の指標、8つのツール。Yank され、0.1.1 に置き換えられました。

できること

ツール	用途
list_indicators	利用可能なすべての指標をカテゴリ別に確認します
get_indicator	1つの指標の現在値とその変化を取得します
get_history	トレンド分析やグラフ作成に使える時系列全体を取得します
compare_indicators	同じ期間の2つ以上の指標を比較用に正規化して取得します
release_calendar	今後数日間に予定されている経済レポートを確認します
macro_snapshot	経済全体、または特定のカテゴリを1回の呼び出しで取得します
recession_signals	サーム・ルール、イールドカーブ、クレジットスプレッド、失業保険申請件数、金融環境をそれぞれ評価します
search_indicators	指標名がわからない場合、キーワードで検索します

要件

無料の FRED API キーが必要です。fredaccount.stlouisfed.org/apikeys から申請できます。所要時間は約1分で、費用はかかりません。

インストール

Codex プラグインマーケットプレイス

uv をインストールし、Codex が利用できる PATH 上に uvx があることを確認してください。このプラグインは、公開済みの PyPI リリース us-macro-mcp==0.1.2 をローカルで stdio 経由で起動します。Python 3.10 以降が必要です。 このリリースでは SDK の v1 FastMCP API を使用しているため、ランチャーでは MCP SDK のバージョンを >=1.2,<2 に制限しています。

1. Codex を起動する前に、FRED_API_KEY 環境変数を Codex アプリから利用できるようにしてください。 プラグインはこの変数を MCP サーバーに渡します。キーをファイルに保存したり、インストール時に入力を求めたりすることはありません。 macOS では、次のコマンドをローカルで実行してから、Codex を完全に終了し、再度開いてください。

   launchctl setenv FRED_API_KEY 'YOUR_FRED_API_KEY'
   

   プレースホルダーを自分のキーに置き換えてください。キーをコミットしたり、共有したりしないでください。 launchctl setenv は現在のログインセッションに適用されます。再ログイン後は、もう一度実行してください。 Linux では、そのシェルから Codex を起動する前に変数をエクスポートしてください。 Windows では、ユーザー環境変数を設定し、Codex を再起動してください。

2. Codex で Plugins → Add → Add plugin marketplace を開きます。

3. Source に Signal-Drifts/US-Macro-MCP（または https://github.com/Signal-Drifts/US-Macro-MCP.git）を設定し、Git ref に main を設定します。 Sparse paths は空のままにして、Add marketplace をクリックします。

4. Signal Drifts を選択して US Macro をインストールし、新しいチャットを開始します。

5. 「Use US Macro to list the available indicators」と入力し、続けてマクロのスナップショットを尋ねてみてください。 インジケーターの一覧表示では、検出機能を確認できます。ライブデータの取得には、FRED キーと FRED へのネットワークアクセスも必要です。

Codex CLI でマーケットプレイスを登録することもできます。

codex plugin marketplace add Signal-Drifts/US-Macro-MCP --ref main

カタログは .agents/plugins/marketplace.json にあります。プラグインマニフェストと MCP 設定は plugins/us-macro-mcp/ にあります。プラグインパッケージには独自のバージョンがあります。 プラグイン 0.1.4 は、PyPI サーバー 0.1.2 を使用しています。サーバーのリリースを更新する際は、 プラグインの .mcp.json に記載された PyPI の固定バージョンを更新し、プラグインマニフェストの バージョンを上げてから、マーケットプレイスとインストール済みプラグインを更新してください。

このリポジトリではカスタムマーケットプレイスを提供しています。OpenAI の公開プラグインディレクトリへの掲載には、 別途申請と審査が必要です。現在、ローカル MCP の申請には、承認済みのパートナー組織が必要です。 公式のプラグインパッケージングガイドと デスクトップ専用の申請ガイドをご覧ください。

既存の MCP Registry 識別子 io.github.hgus107/us-macro-mcp はそのまま保持されます。 GitHub リポジトリを移動しても、この Registry 識別子は移行されません。 今後の Python／MCP Registry リリースに記載されるリポジトリリンクは Signal-Drifts を参照します。 PyPI で公開済みのメタデータは、既存のリリースに引き続き紐づきます。

Claude Desktop

claude_desktop_config.json に次の内容を追加してください。

{
  "mcpServers": {
    "us-macro": {
      "command": "uvx",
      "args": ["--from", "us-macro-mcp==0.1.2", "--with", "mcp[cli]>=1.2,<2", "us-macro-mcp"],
      "env": { "FRED_API_KEY": "your_key_here" }
    }
  }
}

Claude Code

claude mcp add us-macro --env FRED_API_KEY=your_key_here -- uvx --from us-macro-mcp==0.1.2 --with 'mcp[cli]>=1.2,<2' us-macro-mcp

その他の MCP クライアント

環境に FRED_API_KEY を設定した状態で、次を実行してください。

uvx --from us-macro-mcp==0.1.2 --with 'mcp[cli]>=1.2,<2' us-macro-mcp

サーバーは stdio 経由で MCP 通信を行います。

動作

ローカルで実行されます。 ホストされているものはありません。クライアントは、ユーザー自身の API キーを使用して、 自分のマシン上でサーバーをサブプロセスとして起動します。FRED への読み取り専用リクエストを除き、データがコンピューターの外部に送信されることはありません。

キャッシュします。 1 回の macro_snapshot で 19 個のインジケーターを一括取得します。また、会話では同じ系列が繰り返し尋ねられる傾向があります。 回答は、数値が実際に変化し得る頻度に合わせた期間、メモリに保持されます。たとえば、米国債利回りのような日次系列は 1 時間、 CPI のような月次系列は半日です。プロセスの終了時にキャッシュは破棄されます。 動作を変えたい場合は、fred.py の CACHE_SECONDS を調整してください。

API キーをログに記録することはありません。 リクエストのログに記録されるのはエンドポイント、系列、ステータスコードのみです。 また、エラーテキストは書き込みまたは返却の前に、キーを含まないよう加工されます。

既知の制限事項

• ISM製造業PMIとサービス業PMIは利用できません。 ISMはデータを商用ライセンスで提供しており、FREDから取り下げました。Conference Board Consumer Confidence Indexも同様です。いずれも無料で入手できるソースはありません。
• 金利は全国平均であり、銀行ごとの金利ではありません。 30年住宅ローン金利は、Freddie Macが数千の貸し手を対象に実施する週間調査の結果であり、特定の銀行が提示する金利ではありません。金融機関ごとの金利を無料で公開しているところはありません。
• FOMCの会合日程は含まれていません。 FREDが公開しているのはデータの公表スケジュールであり、連邦準備制度の会合カレンダーではありません。
• ミシガン大学消費者信頼感指数の公表には遅れがあります。 本稿の執筆時点では、FREDのUMCSENTとMICHの系列は、他の月次指標より約2か月遅れています。実際に取得したデータは、常にlatest_dateフィールドで確認してください。
• データの日付は対象期間を示します。 6月のCPIは2026-06-01と記録され、7月中旬に公表されます。最新月のデータがすでに存在すると思い込まず、必ずlatest_dateを確認してください。

データソースと免責事項

すべてのデータはFREDから取得しています。FREDはセントルイス連邦準備銀行が運営しており、労働統計局、経済分析局、国勢調査局、連邦準備制度理事会などからデータを集約しています。

recession_signalsツールは、公開データに既知の統計的しきい値を適用します。これは予測ではなく、このサーバーが返す情報は投資助言ではありません。

年次メンテナンスチェックリスト

連邦準備制度理事会は会合日程を約2年前に公表しており、Python、MCP SDK、FRED 独自のカタログはいずれも1年の間に変化します。毎年1月にこのリストに沿って作業し、新しいリリースを作成してください。

データ

• src/us_macro_mcp/fomc.py の FOMC 日程を federalreserve.gov/monetarypolicy/fomccalendars.htmから更新し、 VALID_THROUGH を先の日付に変更します。日程のリストが尽きると、next_fomc_meeting フィールドは空になります。

• カタログ内のすべてのシリーズ ID を再検証します。FRED は予告なしにシリーズを廃止します。ADP の雇用シリーズもこのように廃止され、観測値がゼロ件の有効な応答を返すようになりました。

  cd ~/Downloads/Apps/US-Macro-MCP && uv run python -c "
  import asyncio, logging
  logging.getLogger('us_macro_mcp').setLevel(logging.WARNING)
  from us_macro_mcp import catalog, fred
  async def main():
      sem = asyncio.Semaphore(8)
      async def check(i):
          async with sem:
              try:
                  p = await fred.get_observations(i.series_id, start='2025-01-01', frequency_hint=i.frequency)
                  return (i.name, 'OK' if p else 'EMPTY', p[-1]['date'] if p else '-')
              except Exception as e:
                  return (i.name, 'FAIL: ' + str(e)[:70], '-')
      rows = await asyncio.gather(*(check(i) for i in catalog.CATALOG))
      print('problems:', [r for r in rows if r[1] != 'OK'])
  asyncio.run(main())
  "
  

• これまで利用できなかったデータが無料になっていないか確認します。特に、現在 FRED にはない ISM PMI と Conference Board Consumer Confidence Index を確認してください。

• FRED の API 利用規約とレート制限（現在はキーごとに毎分120リクエスト）に変更がないか確認します。

依存関係

• mcp SDK を更新し、破壊的変更がないか変更履歴を確認します。FastMCP は公式 SDK の一部であるため、メジャーバージョンの更新により、ツールの宣言方法やサーバーの起動方法が変わることがあります。
• MCP 仕様でトランスポートやツールスキーマが改訂されていないか確認します。
• httpx を更新します。
• requires-python を見直します。サポートが終了したバージョンを削除し、現在の最低バージョンで引き続き問題なくインストールできることを確認します。

リリース

• 8つすべてのツールに加え、負のケースと境界ケースを含めて、テスト一式を実行します。
• pyproject.toml と server.json のバージョンを更新します。バージョンが一致しないとレジストリで公開が拒否されます。
• PyPI に uv build と uv publish を実行します。
• 公式 MCP レジストリに mcp-publisher publish を実行します。
• GitHub でリリースにタグを付けます。

ライセンス

MIT

サポートとポリシー

• サポートとバグ報告
• プライバシーポリシー
• ソフトウェアとデータの利用条件