FRED Macroeconomic Data

🚀 FRED 宏觀經濟數據 MCP 服務器

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 venv
source .venv/bin/activate  # 在 Windows 中，使用 `.venv\Scripts\activate`

3. 安裝依賴項：

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/ 替換為您的實際路徑。您可以通過在終端中運行 which uv 找到 uv 的路徑。

💻 使用示例

在 Claude 中使用

1. 首先，在線搜索“如何在 Claude Desktop 客戶端中使用 MCP 資源”，以瞭解如何將 MCP 資源包含在對話中。
2. 添加資源後，即可與 FRED 數據進行交互。示例提示：

使用 FRED API 獲取美國過去 20 年的 GDP，繪製圖表

可用資源

• file://series/available - 列出所有可用的 FRED 系列及其詳細信息。

🔧 故障排除

如果在安裝或配置過程中遇到問題，請檢查以下內容：

1. 確保已正確設置 FRED_API_KEY。
2. 確認 Python 和 uv 已正確安裝。
3. 驗證網絡連接，確保可以訪問外部 API。

如仍有問題，請參考相關文檔或聯繫支持團隊。