FRED 거시경제 데이터 MCP 서버

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

특징

• 일반적인 FRED 경제 지표(GDP, 고용, 인플레이션 등)에 대한 접근

• FRED 데이터 시리즈 검색 기능

• FRED API에서 실시간 데이터 가져오기

• LLM 소비를 위한 표준화된 데이터 형식

• 원활한 통합을 위해 MCP Python SDK를 사용하여 구축됨

Related MCP server: fred-mcp

필수 조건

• Python 3.11 이상

• uv - 최신 Python 패키지 설치 프로그램

• 로컬 사용을 위한 Claude Desktop

• FRED API 키( FRED API 에서 하나 받음)

설치

1. 저장소를 복제합니다.

지엑스피1

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

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

3. 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"

4. 환경 변수 설정:

cp .env.example .env

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

FRED_API_KEY=your_fred_api_key_here

Claude Desktop에 설치

1. Claude Desktop이 설치되어 실행 중인지 확인하세요.

2. 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의 경로를 확인할 수 있습니다.

클로드에서의 사용법

1. 먼저, "Claude Desktop Client에서 MCP 리소스 사용"을 온라인에서 검색하여 대화에 MCP 리소스를 포함시키는 방법을 알아보세요.

2. 리소스를 추가하면 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 시리즈 검색

개발

개발 및 테스트를 위해:

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

mcp dev fred_macroeco_server.py

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

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

python fred_macroeco_server.py

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

문제 해결

1. API 키 오류가 발생하는 경우:

   • .env 에 FRED API 키가 올바르게 설정되었는지 확인하세요.

   • .env 파일이 올바른 디렉토리에 있는지 확인하세요

2. Claude Desktop에 서버가 나타나지 않는 경우:

   • claude_desktop_config.json 경로를 다시 확인하세요.

   • uv와 모든 종속성이 올바르게 설치되었는지 확인하세요.

   • Claude Desktop을 다시 시작해 보세요.

감사의 말

• FRED API를 제공해 주신 세인트루이스 연방준비은행

• MCP SDK를 위한 모델 컨텍스트 프로토콜 팀

• Claude를 위한 Anthropic 및 Claude Desktop 클라이언트