Skip to main content
Glama
Sign In
enesjakozh

MCP-FREDAPI

by Jaldekoa
GitHub
Python
MIT License
2
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP-FREDAPI

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

目次

導入

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
  1. このリポジトリをクローンします:
git clone https://github.com/Jaldekoa/mcp-fredapi.git cd mcp-fredapi
  1. 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 ドキュメントを参照してください。

パラメータタイプ説明許容値デフォルト値状態
シリーズIDstr経済シリーズの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、41✅ 動作します
リアルタイム開始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 , and output_type`。
  • ❌非稼働パラメータ: realtime_start 、 realtime_end 、 limit 、 offset 、 observation_start 、 observation_end 、およびvintage_dates 。

最良の結果を得るには、クエリで有効なパラメータを使用してください。今後のアップデートでこれらの制限が解消される可能性があります。

例

米国の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 ファイルを参照してください。

参考文献

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

モデル コンテキスト プロトコルを通じてセントルイス連邦準備銀行 (FRED) の経済データへのアクセスを提供し、AI アシスタントが経済の時系列データを直接取得できるようにします。

  1. 目次
    1. 導入
      1. インストール
        1. 方法1: pipを使用する
        2. 方法2: uvを使用する（推奨）
      2. 構成
        1. FRED APIキー
        2. クロード/カーソル設定
      3. 利用可能なツール
        1. get\_fred\_series\_observations
      4. パラメータ
        1. 例
          1. 米国のGDPデータの入手
          2. GDPデータを降順で取得する
          3. 年間GDPデータの取得
          4. インフレ率の取得
          5. 異なる出力形式
        2. 貢献
          1. ライセンス
            1. 参考文献

              Related Resources

              Related MCP Servers

              • FRED MCP Server

                kablewy
                A
                security
                F
                license
                A
                quality
                A Model Context Protocol server that provides tools to search and retrieve economic data series from the Federal Reserve Economic Data (FRED) API.
                Last updated -
                2
                3
                TypeScript

              • Financial Datasets MCP Serverofficial

                financial-datasets
                -
                security
                A
                license
                -
                quality
                MCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.
                Last updated -
                253
                Python
                MIT License
                • Apple

              • Beanquery MCP Server

                vanto
                -
                security
                A
                license
                -
                quality
                An experimental server implementing the Model Context Protocol to allow AI assistants to query and analyze financial data stored in Beancount ledger files using the Beancount Query Language.
                Last updated -
                2
                Python
                MIT License

              • Financial Modeling Prep MCP Server

                shadi-fsai
                -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that enables AI assistants like Claude to programmatically access financial data from Financial Modeling Prep API, including company profiles, financial statements, metrics, SEC filings, and market data.
                Last updated -
                5
                Python
                MIT License

              View all related MCP servers

              Appeared in Searches

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/Jaldekoa/mcp-fredapi'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server