재무 모델링 준비(FMP) MCP 서버

표준화된 인터페이스를 통해 재무 모델링 준비(FMP) API 데이터에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 클로드와 같은 AI 비서가 재무 데이터에 프로그래밍 방식으로 액세스할 수 있습니다.

특징

• 회사 프로필 : 회사 정보, 설명, 시가총액, 직원 수 및 업계 데이터에 액세스하세요.

• 재무제표 : 손익계산서, 대차대조표, 현금흐름표 검색

• 재무 지표 : 주요 지표, 비율 및 성장 데이터를 얻으세요

• 분석가 데이터 : 분석가 추정치 및 권장 사항에 액세스하세요

• SEC 제출 : SEC 제출 내용 찾기 및 검색

• 수익 보고서 : 수익 보고서 전화 회의록 받기

• 시장 데이터 : 현재 주가 및 국채 수익률에 접근하세요

• 경쟁사 분석 : 경쟁사 찾기

Related MCP server: Ledger CLI MCP Server

설치

필수 조건

• Python 3.8 이상

• UV 패키지 관리자(권장) 또는 pip

• 재무 모델링 준비 API 키

설정

1. 이 저장소를 복제하세요

2. API 키로 프로젝트 루트에 .env 파일을 만듭니다.

   지엑스피1

3. UV를 사용하여 종속성을 설치합니다(권장):

   uv venv
   uv pip install -r requirements.txt

   또는 pip를 사용하면:

   pip install -r requirements.txt

서버 실행

UV 사용(권장)

UV는 종속성 해결 및 설치를 더 빠르게 제공합니다. UV로 서버를 실행하려면:

# Activate the virtual environment
uv venv activate

# Run the server
python fmp_mcp_server.py

서버가 시작되고 기본 MCP 포트에서 연결을 수신합니다.

pip 사용하기

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Run the server
python fmp_mcp_server.py

Claude Desktop과 연결

Claude Desktop은 MCP 서버에 연결하여 재무 데이터에 접근할 수 있습니다. 설정 방법은 다음과 같습니다.

1. Claude Desktop 다운로드

2. claude_desktop_config.json을 편집합니다: "fmp_mcp_server": { "command": "uv", "args": [ "--directory", "REPO에 대한 절대 디렉토리로 교체", "run", "fmp_mcp_server.py" ] }

이제 Claude는 MCP 인터페이스를 통해 FMP 데이터를 사용할 수 있습니다. Claude에게 다음 작업을 요청할 수 있습니다.

• 회사 프로필을 받으세요

• 재무제표 검색

• SEC 제출물 찾기

• 시장 데이터에 접근하세요

• 그리고 더 많은 것들!

Claude에 대한 예제 쿼리

연결되면 Claude에게 다음과 같은 질문을 할 수 있습니다.

• "3년 장기 투자를 고려하고 있는데, 애플에 투자하는 게 좋을까요?"

• "테슬라의 최신 분기별 손익 계산서를 보여주세요"

• "Microsoft의 최신 10-K 신고서 찾기"

• "아마존의 주요 경쟁자는 누구인가요?"

• "Meta의 최신 수익 보고서를 받으세요"

구성 옵션

서버는 다음과 같은 환경 변수를 지원합니다.

• FMP_KEY : 재무 모델링 준비 API 키(필수)

• SEC_ACCESS : SEC API 액세스를 위한 회사 이름 및 이메일(선택 사항)

캐싱

서버는 API 호출을 줄이고 성능을 개선하기 위해 캐싱 시스템을 구현합니다.

• 재무 데이터는 분기/연도별로 캐시됩니다.

• 프로필 데이터는 매월 캐시됩니다.

• 일일 가격 데이터는 현재 날짜에 캐시됩니다.

캐시 파일은 DataCache 디렉토리에 저장됩니다.

벌채 반출

로그는 회전이 활성화된 logs 디렉토리에 기록됩니다.

• 최대 로그 파일 크기: 10MB

• 백업 파일 수: 5

특허

MIT 라이센스

감사의 말

• API 제공을 위한 재무 모델링 준비

• 모델 컨텍스트 프로토콜 구현을 위한 MCP 서버