Integrations
Used for configuration to securely store and access the FRED API key through environment variables
MCP-FREDAPI
FRED (連邦準備制度経済データ) API とモデルコンテキストプロトコル (MCP) の統合
目次
導入
MCP-FREDAPIは、モデルコンテキストプロトコルを介してセントルイス連邦準備銀行（FRED）の経済データへのアクセスを提供します。この統合により、Cursorやその他のMCP互換環境と併用することで、ClaudeのようなAIアシスタントが経済時系列データを直接取得できるようになります。
このパッケージは公式の FRED APIと統合され、特に経済指標の時系列データを提供するseries_observations エンドポイントに重点を置いています。
インストール
インストール方法は 2 つあります。
方法1: pipを使用する
必要な依存関係をインストールします。
このリポジトリをクローンします:
方法2: uvを使用する（推奨）
この方法は、mcp.json に示されている構成と一致するため、推奨されます。
- まず、まだインストールしていない場合は uv をインストールします。
- このリポジトリをクローンします:
- uv を使用してサーバーを実行します (依存関係を個別にインストールする必要はありません)。
構成
FRED APIキー
FRED API キーが必要になります。これはFRED APIから取得できます。
プロジェクト ルートに.envファイルを作成します。
クロード/カーソル設定
この MCP サーバーを使用するように Cursor を構成するには、 ~/.cursor/mcp.jsonファイルに次のコードを追加します。
/path/to/mcp-fredapiを、システム上のリポジトリへの実際のパスに置き換えてください。例:
注: Windows では、パスにスラッシュ/または二重のバックスラッシュ\\のいずれかを使用できます。
利用可能なツール
get_fred_series_observations
FRED から経済時系列観測を取得します。
Cursor で Claude を使用する場合、次の方法でこのツールに直接アクセスできます。
パラメータ
get_fred_series_observationsツールは以下のパラメータを受け入れます。各パラメータの詳細な技術的詳細については、公式の FRED API ドキュメントを参照してください。
| パラメータ | タイプ | 説明 | 許容値 | デフォルト値 | 状態 |
|---|---|---|---|---|---|
| シリーズID | str | 経済シリーズのID | - | （必須） | ✅ 動作します |
| 並べ替え順序 | str | 観測値の並び替え順 | 「昇順」、「降順」 | '昇順' | ✅ 動作します |
| ユニット | str | データ値の変換 | 「lin」、「chg」、「ch1」、「pch」、「pc1」、「pca」、「cch」、「cca」、「log」 | 「リン」 | ✅ 動作します |
| 頻度 | str | 観察頻度 | 'd'、'w'、'bw'、'm'、'q'、'sa'、'a'、'wef'、'weth'、'wew'、'wetu'、'wem'、'wesu'、'wesa'、'bwew'、'bwem' | なし | ✅ 動作します |
| 集計方法 | str | 頻度の集計方法 | 「平均」、「合計」、「eop」 | '平均' | ✅ 動作します |
| 出力タイプ | 整数 | 観測の出力タイプ | 1、2、3、4 | 1 | ✅ 動作します |
| リアルタイム開始 | str | リアルタイム期間の開始 (YYYY-MM-DD) | - | なし | ❌ 動作しない |
| リアルタイム終了 | str | リアルタイム期間の終了日（YYYY-MM-DD） | - | なし | ❌ 動作しない |
| 制限 | 整数/文字列 | 返される観測の最大数 | 1から100000の間 | 10 | ❌ 動作しない |
| オフセット | 整数/文字列 | 最初からスキップする観測数 | - | 0 | ❌ 動作しない |
| 観察開始 | str | 観察開始日（YYYY-MM-DD） | - | なし | ❌ 動作しない |
| 観察終了 | str | 観察終了日（YYYY-MM-DD） | - | なし | ❌ 動作しない |
| ヴィンテージ日付 | str | ヴィンテージ日付のカンマ区切りリスト | - | なし | ❌ 動作しない |
[!WARNING]パラメータの互換性に関する注意
MCP 実装の現在の制限により、特定のパラメータのみが正しく機能します。
- ✅動作パラメータ：
series_id、sort_order、units、frequency、 aggregation_method, andoutput_type`。- ❌非稼働パラメータ:
realtime_start、realtime_end、limit、offset、observation_start、observation_end、およびvintage_dates。最良の結果を得るには、クエリで有効なパラメータを使用してください。今後のアップデートでこれらの制限が解消される可能性があります。
例
米国のGDPデータの入手
Cursor で Claude を使用する場合、次のように GDP データを要求できます。
GDPデータを降順で取得する
年間GDPデータの取得
インフレ率の取得
消費者物価指数データをパーセント変化付きで取得するには:
異なる出力形式
貢献
ご協力をお待ちしております。以下の手順に従ってください。
- リポジトリをフォークする
- 機能ブランチを作成する (
git checkout -b feature/amazing-feature) - 変更を加える
- 変更をコミットします（
git commit -m 'Add an amazing feature'） - ブランチにプッシュする (
git push origin feature/amazing-feature) - プルリクエストを開く
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
参考文献
- FRED API ドキュメント - シリーズの観察- このプロジェクトで使用される FRED API エンドポイントの公式ドキュメント。
- FRED API - API キーの取得と一般的な API ドキュメントに関する情報。
- モデル コンテキスト プロトコル- モデル コンテキスト プロトコルのドキュメント。
You must be authenticated.
モデル コンテキスト プロトコルを通じてセントルイス連邦準備銀行 (FRED) の経済データへのアクセスを提供し、AI アシスタントが経済の時系列データを直接取得できるようにします。
- Table of Contents
- Introduction
- Installation
- Configuration
- Available Tools
- Parameters
- Examples
- Contributing
- License
- References