关键词

FRED经济数据金融数据CPI逆回购

项目简介

这是一个基于 Model Context Protocol (MCP) 构建的服务器实现，旨在向支持 MCP 协议的大语言模型 (LLM) 客户端提供访问美国联邦储备银行经济数据库 (FRED®) 的能力。通过这个服务器，LLM 可以方便地获取 FRED 中的各种经济数据系列。

主要功能点

  • 访问 FRED 经济数据： 允许 LLM 通过标准接口获取 FRED 数据库中的经济时间序列数据。
  • 提供特定经济指标工具： 当前支持获取每日逆回购协议数据 (RRPONTSYD) 和消费者物价指数数据 (CPIAUCSL)。
  • 数据查询参数支持： 支持根据日期范围、返回的数据条数限制以及排序方式来查询数据。
  • 标准化数据输出： 将获取的经济数据以结构化的 JSON 格式返回给 LLM。

安装步骤

  1. 克隆仓库： 
    git clone https://github.com/stefanoamorelli/fred-mcp-server.git
cd fred-mcp-server
  2. 安装依赖： 
    pnpm install
  3. 构建项目： 
    pnpm build

服务器配置

本服务器需要一个 FRED® API Key。您可以从 FRED® 网站 (https://fred.stlouisfed.org/docs/api/api_key.html) 获取。

将此服务器安装到您的系统中（例如，放置在某个目录）。然后，在您的 MCP 客户端（例如 Claude Desktop）的配置文件中添加以下条目，以便客户端能够启动并连接到此 MCP 服务器。

在客户端配置文件中找到 MCP 服务器配置部分（通常是 'mcpServers' 或类似名称），添加一个新条目：

  • 服务器名称： 您可以给服务器起一个易于识别的名称，例如 '"FRED MCP Server"'。
  • 启动命令 (command)： 指定用于运行服务器的可执行文件路径。通常是 'node' 或其完整路径（例如 '/usr/bin/node'）。
  • 命令参数 (args)： 指定传递给启动命令的参数，这应该是构建后的服务器主脚本的路径。例如：'["<您的克隆仓库路径>/fred-mcp-server/build/index.js"]'。请将 '<您的克隆仓库路径>' 替换为您实际克隆仓库的目录路径。
  • 环境变量 (env)： 设置服务器运行所需的环境变量。需要设置 'FRED_API_KEY' 环境变量，值为您的 FRED API Key。例如：'{ "FRED_API_KEY": "<您的 FRED API Key>" }'。

示例配置结构（请根据您的客户端实际格式调整）：

为一个名为 "FRED MCP Server" 的条目，指定：

  • command 为 node 可执行文件路径
  • args 为构建后服务器主脚本 build/index.js 的路径
  • env 中设置 FRED_API_KEY 环境变量为您的 API Key

基本使用方法

  1. 完成安装和客户端配置。
  2. 启动您的 MCP 客户端。客户端会根据配置启动 FRED MCP 服务器。
  3. 一旦服务器成功连接，LLM 客户端就具备了调用 FRED 经济数据工具的能力。
  4. 您可以向 LLM 提问，引导其使用可用的工具来获取 FRED 数据。例如，您可以让 LLM 调用 'RRPONTSYD' 工具来获取每日逆回购协议数据，或调用 'CPIAUCSL' 工具来获取消费者物价指数数据。

信息

分类

数据库与文件

访问项目