关键词

经济数据FRED API时间序列数据检索金融数据

项目简介

该项目是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为语言模型 (LLM) 客户端提供访问美国联邦储备经济数据 (FRED) API 的能力。它通过定义工具，使得 LLM 能够搜索和检索 FRED 数据库中的经济时间序列数据。

主要功能点

  • 经济数据搜索: 提供工具以关键词搜索 FRED 经济数据序列。
  • 数据序列检索: 提供工具以检索特定经济数据序列的观测数据，并支持日期范围、频率调整等高级选项。
  • MCP 协议支持: 遵循 Model Context Protocol 标准，易于与 MCP 客户端集成。
  • 基于 Stdio 传输: 使用标准输入/输出 (Stdio) 作为 MCP 服务器的传输协议。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/kablewy/fred-mcp-server
cd fred-mcp-server

  2. 安装依赖:

    npm install

  3. 配置 FRED API 密钥:

    • 访问 FRED API 官网 申请 API 密钥。
    • 复制 '.env.example' 文件并重命名为 '.env'。
    • 编辑 '.env' 文件，将您的 FRED API 密钥填入 'FRED_API_KEY' 变量。例如： 
      FRED_API_KEY=您的API密钥

服务器配置

MCP 客户端需要以下配置信息来启动和连接到 FRED MCP 服务器。请将以下 JSON 配置添加到您的 MCP 客户端配置中：

{
  "serverName": "fred-mcp-server",
  "command": "npm",
  "args": ["start"]
}
  • 'serverName': 服务器的名称，可以自定义，用于在客户端中标识该服务器。
  • 'command': 启动服务器的命令。这里使用 'npm' 命令来运行 'package.json' 中定义的 'start' 脚本。
  • 'args': 传递给 'command' 的参数数组。'["start"]' 表示运行 'npm start' 命令。

基本使用方法

  1. 启动服务器: 在项目根目录下运行以下命令启动服务器：

    npm start

    服务器将通过 Stdio 监听 MCP 客户端的请求。

  2. MCP 客户端交互: 配置并启动 MCP 客户端，客户端将通过 Stdio 与 FRED MCP 服务器建立连接。客户端可以使用 'ListToolsRequest' 请求获取可用的工具列表，并使用 'CallToolRequest' 请求调用具体的工具，例如 'search' 工具搜索经济数据或 'series' 工具获取指定序列的数据。

    具体的工具调用参数和返回结果请参考 'src/tools.ts' 文件中 'tools' 数组的定义和说明。例如，调用 'search' 工具搜索 "unemployment rate" 的示例请求 (JSON-RPC 格式) 如下：

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "callTool",
  "params": {
    "name": "search",
    "arguments": {
      "searchText": "unemployment rate"
    }
  }
}

    服务器将返回包含搜索结果的 JSON-RPC 响应。

信息

分类

网页与API

访问项目