FRED 거시경제 데이터 MCP 서버

Claude 및 기타 LLM 클라이언트를 통해 연방준비제도이사회 경제 데이터(FRED)에 접근할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 FRED 경제 데이터 시리즈, 검색 기능 및 데이터 검색 도구를 제공합니다.

특징

일반적인 FRED 경제 지표(GDP, 고용, 인플레이션 등)에 대한 접근
FRED 데이터 시리즈 검색 기능
FRED API에서 실시간 데이터 가져오기
LLM 소비를 위한 표준화된 데이터 형식
원활한 통합을 위해 MCP Python SDK를 사용하여 구축됨

필수 조건

Python 3.11 이상
uv - 최신 Python 패키지 설치 프로그램
로컬 사용을 위한 Claude Desktop
FRED API 키( FRED API 에서 하나 받음)

설치

저장소를 복제합니다.

지엑스피1

uv를 사용하여 가상 환경을 만들고 활성화합니다.

uv venv
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`

uv를 사용하여 종속성을 설치합니다.

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"

환경 변수 설정:

cp .env.example .env

.env 편집하고 FRED API 키를 추가하세요.

FRED_API_KEY=your_fred_api_key_here

Claude Desktop에 설치

Claude Desktop이 설치되어 실행 중인지 확인하세요.
Claude Desktop 설정 열기:
- 설정 > 개발자 > 구성 편집으로 이동하세요.
- claude_desktop_config.json 에 다음 구성을 추가하세요.

{
  "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/ 실제 경로로 바꾸세요. 터미널에서 which uv 실행하면 uv의 경로를 확인할 수 있습니다.

클로드에서의 사용법

먼저, "Claude Desktop Client에서 MCP 리소스 사용"을 온라인에서 검색하여 대화에 MCP 리소스를 포함시키는 방법을 알아보세요.
리소스를 추가하면 FRED 데이터와 상호 작용할 수 있습니다. 예시 프롬프트:

Use FRED APIs to get GDPs of USA last 20 years, draw chart

사용 가능한 리소스

file://series/available - 사용 가능한 모든 FRED 시리즈와 해당 세부 정보 나열

사용 가능한 도구

fetch_series_data - 모든 FRED 시리즈에 대한 데이터 가져오기
search_series - 설명으로 FRED 시리즈 검색

개발

개발 및 테스트를 위해:

MCP 검사기를 실행하여 서버를 테스트하세요.

mcp dev fred_macroeco_server.py

이를 통해 리소스를 검사하고, 도구를 테스트하고, 서버 기능을 확인할 수 있습니다.

직접 서버 실행(문제 확인):

python fred_macroeco_server.py

참고: 서버는 Claude Desktop과의 통신에 stdio 전송을 사용합니다. 개발 중에는 MCP Inspector를 사용하여 Claude Desktop에 배포하기 전에 문제를 파악하고 수정하세요.

문제 해결

API 키 오류가 발생하는 경우:
- .env 에 FRED API 키가 올바르게 설정되었는지 확인하세요.
- .env 파일이 올바른 디렉토리에 있는지 확인하세요
Claude Desktop에 서버가 나타나지 않는 경우:
- claude_desktop_config.json 경로를 다시 확인하세요.
- uv와 모든 종속성이 올바르게 설치되었는지 확인하세요.
- Claude Desktop을 다시 시작해 보세요.

감사의 말

FRED API를 제공해 주신 세인트루이스 연방준비은행
MCP SDK를 위한 모델 컨텍스트 프로토콜 팀
Claude를 위한 Anthropic 및 Claude Desktop 클라이언트

This server cannot be installed

security - not tested

license - not tested

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Claude 및 기타 LLM 클라이언트를 통해 연방준비제도이사회 경제 데이터(FRED)에 대한 액세스를 제공하여 사용자가 GDP, 고용, 인플레이션 데이터와 같은 경제 지표를 검색, 추출 및 시각화할 수 있도록 합니다.

Related MCP Servers

Cryptocurrency Market Data MCP Server
Nayshins
A
security
A
license
A
quality
Provides real-time and historical cryptocurrency market data through integration with major exchanges. This server enables LLMs like Claude to fetch current prices, analyze market trends, and access detailed trading information.
Last updated -
7
26
Python
MIT License
FRED MCP Server
kablewy
A
security
F
license
A
quality
A Model Context Protocol server that provides tools to search and retrieve economic data series from the Federal Reserve Economic Data (FRED) API.
Last updated -
2
3
TypeScript
Fiscal Data MCP Server
QuantGeekDev
A
security
F
license
A
quality
Connects to the US Treasury's Fiscal Data API, enabling users to fetch specific treasury statements, access historical data, and generate formatted reports.
Last updated -
12
6
TypeScript
MCP-FREDAPI
Jaldekoa
A
security
A
license
A
quality
Provides access to economic data from the Federal Reserve Bank of St. Louis (FRED) through the Model Context Protocol, allowing AI assistants to retrieve economic time series data directly.
Last updated -
1
2
Python
MIT License

View all related MCP servers

FRED Macroeconomic Data MCP Server