FRED マクロ経済データ MCP サーバー

Claude およびその他の LLM クライアントを通じて連邦準備制度理事会経済データ (FRED) へのアクセスを提供するモデルコンテキストプロトコル (MCP) サーバー。このサーバーは、FRED 経済データシリーズ、検索機能、およびデータ取得ツールを公開します。

特徴

• 一般的な FRED 経済指標 (GDP、雇用、インフレなど) へのアクセス

• FRED データシリーズの検索機能

• FRED APIからのリアルタイムデータ取得

• LLM 消費のための標準化されたデータ形式

• シームレスな統合のためにMCP Python SDKを使用して構築されています

Related MCP server: fred-mcp

前提条件

• Python 3.11以上

• uv - 最新の Python パッケージインストーラー

• ローカル使用のためのClaudeデスクトップ

• FRED API キー ( FRED APIから取得)

インストール

1. リポジトリをクローンします。

git clone https://github.com/yourusername/WM_mcp.git
cd WM_mcp

2. uv を使用して仮想環境を作成し、アクティブ化します。

uv venv
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`

3. uv を使用して依存関係をインストールします。

uv pip install "mcp[cli]>=1.6.0" "colorama>=0.4.6" "numpy>=2.2.4" "pandas>=2.2.3" "python-dotenv>=1.1.0" "requests>=2.32.3"

4. 環境変数を設定します。

cp .env.example .env

.envを編集して FRED API キーを追加します。

FRED_API_KEY=your_fred_api_key_here

Claude Desktopへのインストール

1. Claude Desktopがインストールされ、実行されていることを確認してください

2. Claude デスクトップの設定を開きます。

   • 設定 > 開発者 > 設定の編集に移動します

   • claude_desktop_config.jsonに次の構成を追加します。

{
  "mcpServers": {
    "FRED Macroeconomic Data Server": {
      "command": "/path/to/your/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/your/WM_mcp",
        "run",
        "fred_macroeco_server.py"
      ]
    }
  }
}

/path/to/your/実際のパスに置き換えてください。ターミナルでwhich uv実行すると、UVのパスを確認できます。

クロードでの使用

1. まず、「Claude デスクトップ クライアントで MCP リソースを使用する」をオンラインで検索して、会話に MCP リソースを含める方法を理解します。

2. リソースを追加すると、FREDデータを操作できるようになります。プロンプトの例：

Use FRED APIs to get GDPs of USA last 20 years, draw chart

利用可能なリソース

• file://series/available - 利用可能なすべての FRED シリーズとその詳細を一覧表示します

利用可能なツール

• fetch_series_data - 任意の FRED シリーズのデータを取得します

• search_series - 説明でFREDシリーズを検索

発達

開発とテストの場合:

1. MCP Inspector を実行してサーバーをテストします。

mcp dev fred_macroeco_server.py

これにより、リソースを検査し、ツールをテストし、サーバーの機能を検証できます。

2. 直接サーバー実行の場合（問題の確認）:

python fred_macroeco_server.py

注: サーバーはClaude Desktopとの通信にstdioトランスポートを使用します。開発中はMCP Inspectorを使用して、Claude Desktopにデプロイする前に問題を検出し修正してください。

トラブルシューティング

1. API キー エラーが発生した場合:

   • FRED APIキーが.envに正しく設定されていることを確認します

   • .envファイルが正しいディレクトリにあることを確認してください

2. Claude Desktop にサーバーが表示されない場合:

   • claude_desktop_config.jsonのパスを再確認してください

   • UVとすべての依存関係が正しくインストールされていることを確認する

   • Claude Desktopを再起動してみてください

謝辞

• FRED APIを提供してくれたセントルイス連邦準備銀行

• MCP SDK のモデル コンテキスト プロトコル チーム

• Claude と Claude デスクトップ クライアントの Anthropic