Integrations
Used for configuration to securely store and access the FRED API key through environment variables
MCP-FREDAPI
FRED(연방준비제도이사회 경제 데이터) API와 모델 컨텍스트 프로토콜(MCP) 통합
목차
소개
MCP-FREDAPI는 모델 컨텍스트 프로토콜(Model Context Protocol)을 통해 세인트루이스 연방준비은행(FRED)의 경제 데이터에 대한 접근을 제공합니다. 이러한 통합을 통해 Claude와 같은 AI 비서가 Cursor 또는 기타 MCP 호환 환경에서 경제 시계열 데이터를 직접 검색할 수 있습니다.
이 패키지는 공식 FRED API 와 통합되어 있으며, 특히 경제 지표에 대한 시계열 데이터를 제공하는 series_observations 엔드포인트 에 초점을 맞춥니다.
설치
설치 방법은 두 가지가 있습니다.
방법 1: pip 사용
필요한 종속성을 설치하세요:
지엑스피1
이 저장소를 복제하세요:
방법 2: uv 사용(권장)
이 방법은 mcp.json에 표시된 구성과 일치하므로 권장됩니다.
- 먼저, 아직 uv가 없다면 설치하세요.
- 이 저장소를 복제하세요:
- uv를 사용하여 서버를 실행합니다(종속성을 별도로 설치할 필요 없음):
구성
FRED API 키
FRED API 키가 필요한데, 이 키는 FRED API 에서 얻을 수 있습니다.
프로젝트 루트에 .env 파일을 만듭니다.
Claude/커서 구성
이 MCP 서버를 사용하도록 Cursor를 구성하려면 ~/.cursor/mcp.json 파일에 다음을 추가하세요.
/path/to/mcp-fredapi 시스템 저장소의 실제 경로로 바꾸세요. 예:
참고: Windows에서는 경로에 슬래시 / 또는 이중 백슬래시 \\ 를 사용할 수 있습니다.
사용 가능한 도구
get_fred_series_observations
FRED에서 경제 시계열 관찰 결과를 검색합니다.
Cursor에서 Claude를 사용하는 경우 다음을 통해 이 도구에 직접 액세스할 수 있습니다.
매개변수
get_fred_series_observations 도구는 다음 매개변수를 허용합니다. 각 매개변수에 대한 자세한 기술 정보는 공식 FRED API 문서를 참조하세요.
| 매개변수 | 유형 | 설명 | 허용된 값 | 기본값 | 상태 |
|---|---|---|---|---|---|
| 시리즈_아이디 | 힘 | 경제 시리즈의 ID | - | (필수의) | ✅ 작동 |
| 정렬 순서 | 힘 | 관찰 결과 정렬 순서 | '오름차순', '내림차순' | '오름차순' | ✅ 작동 |
| 단위 | 힘 | 데이터 값 변환 | 'lin', 'chg', 'ch1', 'pch', 'pc1', 'pca', 'cch', 'cca', 'log' | '린' | ✅ 작동 |
| 빈도 | 힘 | 관찰 빈도 | 'd', 'w', 'bw', 'm', 'q', 'sa', 'a', 'wef', 'weth', 'wew', 'wetu', 'wem', 'wesu', 'wesa', 'bwew', 'bwem' | 없음 | ✅ 작동 |
| 집계 방법 | 힘 | 빈도에 대한 집계 방법 | '평균', '합계', 'eop' | '평균' | ✅ 작동 |
| 출력_유형 | 정수 | 관찰 결과의 출력 유형 | 1, 2, 3, 4 | 1 | ✅ 작동 |
| 실시간 시작 | 힘 | 실시간 기간의 시작(YYYY-MM-DD) | - | 없음 | ❌ 작동하지 않음 |
| 실시간 종료 | 힘 | 실시간 기간 종료(YYYY-MM-DD) | - | 없음 | ❌ 작동하지 않음 |
| 한계 | 정수/문자열 | 반환할 최대 관찰 수 | 1에서 100000 사이 | 10 | ❌ 작동하지 않음 |
| 오프셋 | 정수/문자열 | 처음부터 건너뛸 관찰 수 | - | 0 | ❌ 작동하지 않음 |
| 관찰_시작 | 힘 | 관찰 시작 날짜(YYYY-MM-DD) | - | 없음 | ❌ 작동하지 않음 |
| 관찰_끝 | 힘 | 관찰 종료일(YYYY-MM-DD) | - | 없음 | ❌ 작동하지 않음 |
| 빈티지_날짜 | 힘 | 쉼표로 구분된 빈티지 날짜 목록 | - | 없음 | ❌ 작동하지 않음 |
[!WARNING] 매개변수 호환성에 대한 참고 사항
현재 MCP 구현의 제한으로 인해 일부 매개변수만 제대로 작동합니다.
- ✅ 작업 매개변수 :
series_id,sort_order,units,frequency, aggregation_method, andoutput_type.- ❌ 작동하지 않는 매개변수 :
realtime_start,realtime_end,limit,offset,observation_start,observation_end및vintage_dates.최상의 결과를 얻으려면 쿼리에서 작동하는 매개변수를 고수하세요. 향후 업데이트를 통해 이러한 제한 사항이 해결될 수 있습니다.
예시
미국 GDP 데이터 얻기
Cursor에서 Claude를 사용하면 다음과 같이 GDP 데이터를 요청할 수 있습니다.
내림차순으로 GDP 데이터 가져오기
연간 GDP 데이터 얻기
인플레이션율 얻기
백분율 변화를 포함한 소비자 물가 지수 데이터를 얻으려면:
다른 출력 형식
기여하다
여러분의 참여를 환영합니다. 다음 단계를 따라주세요.
- 저장소를 포크하세요
- 기능 브랜치를 생성합니다(
git checkout -b feature/amazing-feature) - 변경 사항을 만드세요
- 변경 사항을 커밋하세요(
git commit -m 'Add an amazing feature') - 브랜치에 푸시(
git push origin feature/amazing-feature) - 풀 리퀘스트 열기
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
참고문헌
- FRED API 문서 - 시리즈 관찰 - 이 프로젝트에서 사용되는 FRED API 엔드포인트에 대한 공식 문서입니다.
- FRED API - API 키와 일반 API 문서를 얻는 방법에 대한 정보입니다.
- 모델 컨텍스트 프로토콜 - 모델 컨텍스트 프로토콜에 대한 문서입니다.
You must be authenticated.
모델 컨텍스트 프로토콜을 통해 세인트루이스 연방준비은행(FRED)의 경제 데이터에 대한 액세스를 제공하여 AI 보조원이 경제 시계열 데이터를 직접 검색할 수 있도록 합니다.
- Table of Contents
- Introduction
- Installation
- Configuration
- Available Tools
- Parameters
- Examples
- Contributing
- License
- References