FRED (Federal Reserve Economic Data)

🚀 MCP-FRED 使用説明ドキュメント

MCP-FREDは、モデルコンテキストプロトコル（MCP）を通じてFRED APIに接続し、経済データを簡単に取得できるツールです。このドキュメントでは、インストール、設定、使用方法について詳しく説明します。

🚀 クイックスタート

MCP-FREDを使ってFREDのデータにアクセスするには、以下の手順で操作します。

1. クライアントを初期化します。

from mcp_fred import FredClient

client = FredClient(api_key='your_api_key_here')

2. リクエストを送信します。

response = client.get_series_data(series_id='GDP', sort_order='desc')

3. レスポンスを処理します。

print(response.data)

✨ 主な機能

• モデルコンテキストプロトコル（MCP）を通じてFRED APIに接続し、経済データを取得できます。
• 簡潔なインターフェースで、データの取得が容易です。

📦 インストール

2.1 依存関係のインストール

必要なライブラリがインストールされていることを確認してください。

pip install requests

2.2 APIキーの設定

FREDの公式ウェブサイトで登録し、APIキーを取得してください。そのキーをプロジェクトに追加して認証を行います。

💻 使用例

基本的な使用法

# クライアントの初期化
from mcp_fred import FredClient

client = FredClient(api_key='your_api_key_here')

# リクエストの送信
response = client.get_series_data(series_id='GDP', sort_order='desc')

# レスポンスの処理
print(response.data)

高度な使用法

例1: 米国のGDPデータを取得する

response = client.get_series_data(series_id='GDP')

例2: GDPデータを降順で取得する

response = client.get_series_data(series_id='GDP', sort_order='desc')

📚 ドキュメント

必須パラメータ

• series_id (str): データシリーズの一意の識別子で、例えば'GDP' などです。

オプションパラメータ

• sort_order (str, optional): 返されるデータの並び順です。'desc'（降順）または 'asc'（昇順）が選択でき、デフォルトは 'asc' です。
• units (str, optional): データの単位表記で、例えば 'pch' はパーセント変化を表します。
• その他のパラメータには、frequency, aggregation_method, output_type などがあります。

🔧 技術詳細

MCP-FREDは、モデルコンテキストプロトコル（MCP）を通じてFRED APIに接続し、経済データを取得するためのPythonツールです。このツールは、必要なライブラリをインストールし、APIキーを設定することで簡単に使用できます。

📄 ライセンス

このプロジェクトはMITライセンスに基づいています。詳細は LICENSE ファイルを参照してください。

⚠️ 重要提示

APIキーが有効で、正しく設定されていることを確認してください。また、FREDの使用制限（例えば、1分間の最大リクエスト数）に従ってください。

💡 使用建议

エラーを処理するには、client.get_error() メソッドを使用して詳細なエラー情報を取得できます。サポートされているデータ頻度には、'a'（年）、'm'（月）、'q'（四半期）などがあります。

参考資料

• FRED APIドキュメント
• モデルコンテキストプロトコル

詳細な情報が必要な場合や問題が発生した場合は、このドキュメントを参照するか、サポートチームに問い合わせてください。