经济数据服务

一个为联邦储备经济数据(FRED)API提供的MCP服务器,支持搜索经济数据系列、检索数据点、探索分类、发布、来源和标签,并提供分页支持。

  • by fritzprix
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 fritzprix/fred-mcp

使用说明

FRED MCP服务器

美国联邦储备委员会经济数据(FRED)API的MCP服务器。

特性

  • 搜索经济数据系列。
  • 检索系列的数据点。
  • 探索类别、发布、来源和标签。
  • 对大型数据集的分页支持。
  • 将数据保存为JSON文件的选项。

配置

设置 FRED_API_KEY 环境变量添加到FRED API密钥。

用法

与一起跑步 uvx (如已发布):

uvx fred-data-mcp

从PyPI安装

发布后,您可以直接安装并运行:

pip install fred-data-mcp
# or
uvx fred-data-mcp

Claude桌面配置

要将此服务器与Claude Desktop应用程序一起使用,请将以下内容添加到您的 claude_desktop_config.json:

已发布包(推荐)

如果你已经将包发布到PyPI,你可以直接键入包名:

{
  "mcpServers": {
    "fred": {
      "command": "uvx",
      "args": [
        "fred-data-mcp"
      ],
      "env": {
        "FRED_API_KEY": "your_api_key_here"
      }
    }
  }
}

本地开发

如果从源代码存储库运行:

{
  "mcpServers": {
    "fred": {
      "command": "uvx",
      "args": [
        "--from",
        "/absolute/path/to/fred-mcp",
        "fred-data-mcp"
      ],
      "env": {
        "FRED_API_KEY": "your_api_key_here"
      }
    }
  }
}

发展

运行MCP检查器

要使用MCP检查器在本地测试服务器,请执行以下操作:

Windows(PowerShell):

$env:FRED_API_KEY = "your_api_key_here"
.\run-inspector.ps1

猛击:

export FRED_API_KEY="your_api_key_here"
./run-inspector.sh

或者,直接运行命令:

npx @modelcontextprotocol/inspector uv run fred-data-mcp

## Publication

### Publishing to PyPI
A helper script `publish.ps1` is provided to automate version bumping and publication.

**Requirements:**
- `uv` installed.
- PyPI credentials configured (e.g., via `~/.pypirc` or environment variables `TWINE_USERNAME` and `TWINE_PASSWORD`).


**Usage (Windows PowerShell):**
```powershell
# Bump patch version and publish
.\publish.ps1 patch

用法(Bash):

# Bump patch version and publish
./publish.sh patch

要在不上传的情况下测试构建过程,请使用 -DryRun (PS)或 --dry-run (Bash)标志:

.\publish.ps1 patch -DryRun
# or
./publish.sh patch --dry-run