项目简介
此MCP服务器提供对联邦储备经济数据 (FRED) API的访问。它允许LLM检索宏观经济指标并搜索相关数据系列,从而为LLM应用提供经济数据上下文。
主要功能点
- 访问FRED经济数据: 提供对常见FRED经济指标(如GDP、就业、通货膨胀等)的访问。
- 数据搜索功能: 允许用户通过关键词搜索FRED数据系列。
- 实时数据获取: 从FRED API实时获取最新的经济数据。
- 标准化数据格式: 所有数据均以标准化的格式提供,方便LLM客户端解析和使用。
安装步骤
- 克隆仓库: 打开终端,执行命令 'git clone https://github.com/hungson175/WM_MCP.git' 克隆仓库到本地,并进入仓库目录 'cd WM_MCP'。
- 创建并激活虚拟环境: 为了隔离项目依赖,建议创建虚拟环境。执行 'uv venv' 创建虚拟环境,然后执行 'source .venv/bin/activate' (Linux/macOS) 或 '.venv\Scripts\activate' (Windows) 激活虚拟环境。
- 安装依赖: 在虚拟环境中,执行 '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"' 安装项目所需的Python库。
- 配置FRED API密钥: 复制 '.env.example' 文件并重命名为 '.env'。编辑 '.env' 文件,将 'FRED_API_KEY=your_fred_api_key_here' 中的 'your_fred_api_key_here' 替换为您在 FRED API 官网 申请的API密钥。
服务器配置 (用于 Claude Desktop)
要将此MCP服务器配置到 Claude Desktop 客户端,您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。在配置文件中添加 'mcpServers' 字段,并配置 "FRED Macroeconomic Data Server"。配置信息如下:
{ "mcpServers": { "FRED Macroeconomic Data Server": { "command": "/path/to/your/.local/bin/uv", "args": [ "--directory", "/path/to/your/WM_MCP", "run", "fred_macroeco_server.py" ] } } }
请注意:
- 将配置中的 '/path/to/your/' 替换为实际的路径。
- '/path/to/your/.local/bin/uv' 应替换为您 'uv' 命令的完整路径。您可以在终端中运行 'which uv' 来查找 'uv' 的路径。
- '/path/to/your/WM_MCP' 应替换为您克隆的 'WM_MCP' 仓库的完整路径。
- 'command' 字段指定了启动服务器的命令,这里使用了 'uv' 来运行 Python 脚本。
- 'args' 字段指定了传递给 'uv' 命令的参数,包括仓库目录和服务器启动脚本 'fred_macroeco_server.py'。
基本使用方法
- 启动 Claude Desktop: 确保您已安装并启动 Claude Desktop 客户端。
- 配置 MCP 服务器: 按照上述 “服务器配置” 部分的说明,编辑 'claude_desktop_config.json' 文件,添加 FRED宏观经济数据服务器的配置。
- 在 Claude 中使用: 在 Claude Desktop 中,您可以像正常对话一样与 Claude 交互。当您需要使用FRED数据时,可以直接在提示语中指示 Claude 使用 MCP 资源或工具。例如:
- '使用FRED API获取过去20年美国的GDP数据并绘制图表'
- '搜索关于失业率的FRED数据'
可用资源:
- 'file://series/available': 列出所有可用的FRED数据系列及其详细信息。
可用工具:
- 'fetch_series_data': 获取指定FRED数据系列的数据。
- 'search_series': 根据关键词搜索FRED数据系列。
信息
分类
网页与API