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. 저장소를 복제합니다.

지엑스피1

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

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

4. 환경 변수 설정:

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

Claude Desktop에 설치

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

/path/to/your/ 실제 경로로 바꾸세요. 터미널에서 which uv 실행하면 uv의 경로를 확인할 수 있습니다.

클로드에서의 사용법

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

사용 가능한 리소스

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

사용 가능한 도구

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

개발

개발 및 테스트를 위해:

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

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

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

참고: 서버는 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 클라이언트