🚀 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 仓库或联系维护团队。