MCP Fredapi

🚀 MCP-FRED API 集成文檔

MCP-FRED 是一款將 FRED（美聯儲經濟數據）API 與 Model Context Protocol（模型上下文協議）相集成的工具。它能幫助用戶從 FRED API 獲取經濟數據，支持多種數據格式和篩選條件，為經濟數據的獲取和處理提供便利。

🚀 快速開始

MCP-FRED 是一個集成 FRED（美聯儲經濟數據）API 和 Model Context Protocol（模型上下文協議）的工具。本文檔旨在為您提供詳細的使用說明和技術細節。

✨ 主要特性

• 從 FRED API 獲取經濟數據。
• 支持多種數據格式和篩選條件。

📦 安裝指南

必要依賴

• Python 3.6+
• requests 庫：用於 HTTP 請求。
• json 庫：用於 JSON 數據處理。

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/your-repository/mcp-fred.git
   

2. 安裝依賴：

   pip install requests json
   

💻 使用示例

基礎用法

from mcp_fred import FredAPI

# 初始化 API 對象（需要替換為您的 API Key）
fred = FredAPI(api_key="your_api_key_here")

# 獲取 GDP 數據
gdp_data = fred.get_series_data(series_id="GDP")
print(gdp_data)

# 獲取 CPI 數據並指定單位和頻率
cpi_data = fred.get_series_data(
    series_id="CPIAUCSL",
    units="pch",  # 表示年化百分比變化
    frequency="m"  # 表示按月聚合
)
print(cpi_data)

高級用法

# 獲取 GDP 數據並按年度聚合
gdp_annual = fred.get_series_data(
    series_id="GDP",
    frequency="a",
    aggregation_method="sum"
)
print(gdp_annual)

# 獲取 CPI 數據並指定單位和頻率
cpi_monthly = fred.get_series_data(
    series_id="CPIAUCSL",
    units="pch",
    frequency="m"
)
print(cpi_monthly)

📚 詳細文檔

可用參數

📄 許可證

本項目遵循 MIT 許可證，具體內容請參見 LICENSE 文件。

🔗 參考資料

• FRED API 文檔
• Model Context Protocol

如需更多信息，請隨時查閱本項目的 GitHub 倉庫或聯繫維護團隊。