FRED Macroeconomic Data

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

このサーバーは、Claude やその他の LLM クライアントを通じて、連邦準備制度理事会の経済データ（FRED）にアクセスするための Model Context Protocol (MCP) サーバーです。FRED の経済データシリーズ、検索機能、データ検索ツールにアクセスできます。

✨ 主な機能

• 一般的な FRED 経済指標（GDP、雇用、インフレなど）へのアクセス
• FRED データシリーズの検索機能
• FRED API からのリアルタイムデータ取得
• LLM で使用するのに適した標準データ形式
• MCP Python SDK を使用したシームレスな統合構築

📦 インストール

事前準備

• Python 3.11 以上
• uv - 最新の Python パッケージインストーラー
• Claude Desktop をローカルで使用する場合
• FRED API Key（FRED API から取得）

インストール手順

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

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

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

uv venv
source .venv/bin/activate  # Windows の場合は `.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 Desktop の設定を開きます：
   • 設定 > 開発者 > 設定の編集 を選択します。
   • 以下の設定を claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "FRED マクロ経済データサーバー": {
      "command": "/path/to/your/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/your/WM_mcp",
        "実行",
        "fred_macroeco_server.py"
      ]
    }
  }
}

/path/to/your/ を実際のパスに置き換えます。uv のパスは、ターミナルで which uv を実行することで見つけることができます。

💻 使用例

基本的な使用法

1. まず、「Claude Desktop クライアントで MCP リソースを使用する方法」をオンラインで検索し、MCP リソースを会話に含める方法を学びます。
2. リソースを追加した後、FRED データと対話できます。例えば以下のようなプロンプトを使用できます：

使用 FRED API 获取美国过去 20 年的 GDP，绘制图表

利用可能なリソース

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

🔧 トラブルシューティング

インストールまたは設定中に問題が発生した場合は、以下を確認してください。

1. FRED_API_KEY が正しく設定されていることを確認します。
2. Python と uv が正しくインストールされていることを確認します。
3. ネットワーク接続を確認し、外部 API にアクセスできることを確認します。

問題が解決しない場合は、関連ドキュメントを参照するか、サポートチームに連絡してください。