FRED Economic Data

FRED MCP サーバー 📊

FRED（Federal Reserve Economic Data）を利用して、Claude Desktop やあらゆる MCP 対応クライアントから米国および世界の経済データを取得できます。80万件以上の経済時系列データ（GDP、インフレ率、失業率、金利など）を自然言語で検索し、取得できます。

npm パッケージ： fred-economic-mcp  ·  GitHub リポジトリ： danishashko/fred-economic-mcp。

🎯 できること

• 🔎 キーワードで80万件以上の経済時系列データを検索
• 📈 組み込みの変換（レベル、変化率、前年同期比）と頻度集計（日次 → 月次／四半期／年次）を使った観測値の取得
• 🧾 時系列データのメタデータ — 単位、頻度、季節調整、対象期間、注記
• 🇺🇸 経済スナップショット — 主要な米国指標を1回の呼び出しで取得
• 🗂️ トピック別にデータを見つけられるカテゴリの閲覧
• 🗓️ FRED が追跡するリリース情報

すべてのツールは、デフォルトで人が読みやすいマークダウンを返します。また、リクエストに応じて構造化されたJSON（response_format: "json"）を返すこともできます。このサーバーは軽量（Python 標準ライブラリと mcp のみ）で、FRED の変換をサーバー側で適用して AI が整った数値を取得できるようにし、FRED によるレート制限が発生した場合は自動で再試行します。

🔑 無料の API キーを取得する（必須）

FRED の利用には無料の API キーが必要です。取得には約1分かかります。

1. fredaccount.stlouisfed.org でアカウントを作成し、fredaccount.stlouisfed.org/apikeys でキーを申請します。
2. FRED_API_KEY 環境変数を使って、サーバーにキーを渡します（設定方法は以下を参照）。

🚀 クイックスタート

以下を Claude Desktop の設定に追加して、Claude を再起動します。

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fred": {
      "command": "npx",
      "args": ["-y", "fred-economic-mcp"],
      "env": {
        "FRED_API_KEY": "your_free_fred_api_key_here"
      }
    }
  }
}

初回起動時に npx ラッパーが分離された Python 環境を作成し、依存関係をインストールします（初回のみ必要な手順で、1分ほどかかることがあります）。必要なのは、お使いのマシンに Python 3.10+ と Node.js 16+ がインストールされていることだけです。

グローバルインストールを利用する場合

npm install -g fred-economic-mcp

{
  "mcpServers": {
    "fred": {
      "command": "fred-economic-mcp",
      "env": { "FRED_API_KEY": "your_free_fred_api_key_here" }
    }
  }
}

🔧 利用可能なツール

ツール	返される内容	パラメーター
search_series	キーワードに一致する時系列データを人気順に表示（ID、タイトル、単位、頻度）	query、limit
get_series_observations	変換と頻度集計を適用した実際のデータ値	series_id、observation_start、observation_end、units、frequency、sort_order、limit
get_series_info	時系列データのメタデータ（単位、頻度、季節調整、対象期間、注記）	series_id
get_economic_snapshot	主要な米国指標の最新値をまとめたダッシュボード	(なし)
browse_category	FRED カテゴリ内の子カテゴリと人気の時系列データ	category_id
get_releases	FRED が追跡する経済データのリリース情報	limit

各ツールでは response_format（デフォルトの "markdown" または "json"）も指定できます。

get_series_observations の変換（units）： lin レベル · chg 変化 · ch1 前年からの変化 · pch 変化率 · pc1 前年からの変化率 · pca 複利年率 · log 自然対数。

頻度集計（frequency）： 空（元の頻度） · d 日次 · w 週次 · m 月次 · q 四半期 · a 年次。

よく使われるシリーズ ID

ID を覚える必要はありません。search_series で検索できますが、次の ID はよく使われます。

シリーズ ID	指標
GDPC1	実質国内総生産
UNRATE	失業率
CPIAUCSL	消費者物価指数（CPI）
PCEPI	PCE 価格指数（FRB が重視するインフレ指標）
FEDFUNDS	フェデラル・ファンド金利
DGS10	10 年国債利回り
T10Y2Y	10 年国債と 2 年国債の利回りスプレッド
PAYEMS	非農業部門雇用者数
MORTGAGE30US	30 年固定住宅ローン金利
UMCSENT	消費者マインド（ミシガン大学）

💬 プロンプトの例

サーバーに接続したら、Claude に尋ねるだけです。

• 「現在の米国経済はどんな状況ですか？」
• 「現在の失業率はいくらですか？」
• 「過去 12 か月の CPI インフレ率を前年同月比で表示してください。」
• 「10 年国債利回りはいくらですか？今年はどのように推移しましたか？」
• 「消費者信用に関する FRED シリーズを探してください。」
• 「10 年物と 2 年物の利回りスプレッドはいくらですか？イールドカーブは逆転していますか？」
• 「過去 8 四半期の実質 GDP 成長率を比較してください。」
• 「PCEPI シリーズは何を測定し、どのくらいの頻度で更新されますか？」

出力例

「ここ数か月の CPI インフレ率は前年同月比でどのくらいですか？」と尋ねると、 get_series_observations が series_id=CPIAUCSL、units=pc1 で実行されます。

# Consumer Price Index for All Urban Consumers: All Items (CPIAUCSL)

**Units:** Percent change from year ago · **Frequency:** m
**Total observations:** 940

**Latest:** 3.39 (2026-04-01)

| Date       | Value |
|------------|-------|
| 2026-04-01 | 3.39  |
| 2026-03-01 | 3.29  |
| 2026-02-01 | 2.43  |

🐛 トラブルシューティング

「FRED API キーが設定されていません」 MCP クライアントの設定（クイックスタートを参照）で、無料のキーを fredaccount.stlouisfed.org/apikeys から取得して FRED_API_KEY に設定し、クライアントを再起動してください。

「コマンドが見つかりません」／「Python が見つかりません」 Python 3.10 以降と Node.js 16 以降がインストールされ、PATH に設定されていることを確認してください。macOS/Linux では python3 を試してください。

「FRED にリクエストをレート制限されています」 FRED ではキーごとに 1 分あたり 120 件のリクエストが許可されています。サーバーは自動的に再試行します。それでも制限に達する場合は、1 分待ってください。

Claude にツールが表示されない

1. 設定ファイルが有効な JSON であることを確認してください（末尾にカンマを付けないでください）。
2. Claude Desktop を完全に終了してから、再度開いてください。
3. サーバーの env ブロックに FRED_API_KEY が設定されていることを確認してください。

「FRED がリクエストを拒否しました」 シリーズ ID が間違っている可能性があります。search_series で正しい ID を検索するか、get_series_info でシリーズが存在することを確認してください。

異なるモデルやプロバイダーを使用する場合（LiteLLM、OpenRouter、NVIDIA NIM、ローカルモデル） このサーバーがモデルと通信することはありません。クライアントがローカルプロセスとして起動し、stdin/stdout を介して JSON-RPC で通信するため、ANTHROPIC_BASE_URL を変更したり、クライアントが使用するモデルを切り替えたりしても、サーバーには影響しません。そのような切り替え後にツールが実行されなくなった場合は、次の 2 点を確認してください。モデルが関数呼び出しに対応している必要があります。また、未対応のパラメーターを破棄するよう設定されたプロキシは、ツール定義をエラーなしで黙って削除することがあります。サーバーを疑う前に、クライアントで /mcp（または claude mcp list）を実行し、サーバーに接続されていることを確認してください。

🛠️ 手動インストール（代替方法）

npx 経由ではなく、Python ファイルを直接実行する場合は、次の手順に従ってください。

1. サーバーをダウンロードして依存関係をインストールする

fred_mcp.py をコンピューター上の任意の場所に保存してから、次を実行します。

pip install mcp

（macOS/Linux では pip3 を使用してください）

2. Claude Desktop からサーバーを指定する

{
  "mcpServers": {
    "fred": {
      "command": "python3",
      "args": ["/absolute/path/to/fred_mcp.py"],
      "env": { "FRED_API_KEY": "your_key_here" }
    }
  }
}

Windows では "command": "python" と、"C:\\path\\to\\fred_mcp.py" のようなパスを使用してください（バックスラッシュを 2 つ重ねるか、スラッシュを使用します）。

3. Claude Desktop を再起動します。

🔒 プライバシーとレート制限

• 独自の無料 API キーを使用して、公式の FRED API に接続します。
• リクエストはお使いのコンピューターから FRED に直接送信されます。データが保存されたり、プロキシされたりすることはありません。
• FRED ではキーごとに 1 分あたり 120 件のリクエストに制限されています。サーバーは 429 に対して、待ち時間を延ばしながら再試行します。
• 個人利用、教育、研究を目的としています。

📝 注記

• シリーズ ID では大文字と小文字が区別されません（自動的に大文字に変換されます）。たとえば、unrate が使えます。
• FRED は欠損値を . で示します。これらは N/A として表示されます。
• units の変換（前年比を表す pc1 など）は FRED によって計算されるため、値は信頼できるものであり、クライアント側での計算は不要です。
• データの対象範囲と頻度はシリーズによって異なります。期間のデータを取得する前に、get_series_info で確認してください。

📋 変更履歴

全バージョンの履歴については、CHANGELOG.md をご覧ください。

📚 リソース

• Model Context Protocol
• FRED API documentation
• Get a FRED API key

⚖️ 法的免責事項

このツールは FRED® API を使用していますが、Federal Reserve Bank of St. Louis による推奨または認定を受けていません。FRED® は Federal Reserve Bank of St. Louis の登録商標です。FRED API の使用には、利用規約が適用されます。

👤 作成者

Daniel Shashko

• GitHub: @danishashko
• LinkedIn: daniel-shashko
• npm: danielshashko

📄 ライセンス

MIT © Daniel Shashko