MCP-FREDAPI

FRED (連邦準備制度経済データ) API とモデルコンテキストプロトコル (MCP) の統合

目次

• 導入

• インストール

• 構成

  • FRED APIキー

  • クロード/カーソル設定

• 利用可能なツール

• パラメータ

• 例

  • 共通経済シリーズID

• 貢献

• ライセンス

• 参考文献

Related MCP server: Financial Modeling Prep MCP Server

導入

MCP-FREDAPIは、モデルコンテキストプロトコルを介してセントルイス連邦準備銀行（FRED）の経済データへのアクセスを提供します。この統合により、Cursorやその他のMCP互換環境と併用することで、ClaudeのようなAIアシスタントが経済時系列データを直接取得できるようになります。

このパッケージは公式の FRED APIと統合され、特に経済指標の時系列データを提供するseries_observations エンドポイントに重点を置いています。

インストール

インストール方法は 2 つあります。

方法1: pipを使用する

必要な依存関係をインストールします。

pip install "mcp[cli]" httpx python-dotenv

このリポジトリをクローンします:

git clone https://github.com/Jaldekoa/mcp-fredapi.git
cd mcp-fredapi

方法2: uvを使用する（推奨）

この方法は、mcp.json に示されている構成と一致するため、推奨されます。

1. まず、まだインストールしていない場合は uv をインストールします。

pip install uv

2. このリポジトリをクローンします:

git clone https://github.com/Jaldekoa/mcp-fredapi.git
cd mcp-fredapi

3. uv を使用してサーバーを実行します (依存関係を個別にインストールする必要はありません)。

uv run --with mcp --with httpx mcp run server.py

構成

FRED APIキー

FRED API キーが必要になります。これはFRED APIから取得できます。

プロジェクト ルートに.envファイルを作成します。

FRED_API_KEY=your_api_key_here

クロード/カーソル設定

この MCP サーバーを使用するように Cursor を構成するには、 ~/.cursor/mcp.jsonファイルに次のコードを追加します。

{
  "mcpServers": {
    "mcp-fredapi": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-fredapi", "run", "--with", "mcp", "--with", "httpx", "mcp", "run", "server.py"]
    }
  }
}

/path/to/mcp-fredapiを、システム上のリポジトリへの実際のパスに置き換えてください。例:

{
  "mcpServers": {
    "mcp-fredapi": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-fredapi", "run", "--with", "mcp", "--with", "httpx", "mcp", "run", "server.py"]
    }
  }
}

注: Windows では、パスにスラッシュ/または二重のバックスラッシュ\\のいずれかを使用できます。

利用可能なツール

get_fred_series_observations

FRED から経済時系列観測を取得します。

Cursor で Claude を使用する場合、次の方法でこのツールに直接アクセスできます。

@mcp-fredapi:get_fred_series_observations

パラメータ

get_fred_series_observationsツールは以下のパラメータを受け入れます。各パラメータの詳細な技術的詳細については、公式の FRED API ドキュメントを参照してください。

例

米国のGDPデータの入手

Cursor で Claude を使用する場合、次のように GDP データを要求できます。

Can you get the latest GDP data from FRED?

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP"
}

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

Can you get the GDP data in descending order (newest first)?

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP",
  "sort_order": "desc"
}

年間GDPデータの取得

Can you get annual GDP data?

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP",
  "frequency": "a"
}

インフレ率の取得

消費者物価指数データをパーセント変化付きで取得するには:

What's the recent inflation rate in the US?

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "CPIAUCSL",
  "units": "pch",
  "frequency": "m"
}

異なる出力形式

Show me GDP data in a different format.

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP",
  "output_type": 2
}

貢献

ご協力をお待ちしております。以下の手順に従ってください。

1. リポジトリをフォークする

2. 機能ブランチを作成する ( git checkout -b feature/amazing-feature )

3. 変更を加える

4. 変更をコミットします（ git commit -m 'Add an amazing feature' ）

5. ブランチにプッシュする ( git push origin feature/amazing-feature )

6. プルリクエストを開く

ライセンス

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

参考文献

• FRED API ドキュメント - シリーズの観察- このプロジェクトで使用される FRED API エンドポイントの公式ドキュメント。

• FRED API - API キーの取得と一般的な API ドキュメントに関する情報。

• モデル コンテキスト プロトコル- モデル コンテキスト プロトコルのドキュメント。