Financial Modeling Prep API를 위한 Model Context Protocol (MCP) 서버

Financial Modeling Prep API를 위한 Model Context Protocol (MCP) 서버로, 250개 이상의 금융 데이터 도구를 AI 어시스턴트에게 제공합니다.

250개 이상의 금융 도구 — 주식, ETF, 암호화폐, 외환(Forex), 원자재, 경제 등 24개 카테고리에 걸쳐 제공
동적 도구 관리 (Dynamic Tool Management) — toolception을 기반으로 구축되어 메타 도구(meta-tools)를 통해 런타임 시 도구 세트(toolsets)를 활성화/비활성화 가능
세 가지 서버 모드 — 동적(Dynamic, 메타 도구 사용), 정적(Static, 사전 로드된 도구 세트), 또는 모든 도구(All Tools, 기본값)
유연한 배포 — 호스팅된 인스턴스를 사용하거나 npm, Docker 또는 소스 코드를 통해 자체 호스팅 가능
HTTP/SSE 전송 (Transport) — Claude.ai, Claude Desktop 및 MCP 레지스트리와 호환

설치가 필요하지 않습니다. 직접 연결하세요:

세션 설정(session configuration)에 FMP_ACCESS_TOKEN을 제공하면 5개의 메타 도구를 사용하여 필요에 따라 도구 세트를 로드하고 사용을 시작할 수 있습니다.

npx financial-modeling-prep-mcp-server --fmp-token=YOUR_FMP_API_KEY

또는 전역(globally)으로 설치하세요:

npm install -g financial-modeling-prep-mcp-server
fmp-mcp --fmp-token=YOUR_FMP_API_KEY

API 키는 financialmodelingprep.com에서 발급받으세요.

사전 요구 사항 (Prerequisites): Node.js 25.3.0 이상 (v2.6.0+ 기준). 이전 버전(v2.5.x 및 이하)의 경우 Node.js 20 이상이 필요합니다.

워크플로우에 맞는 방법을 선택하세요:

NPM — npm install -g financial-modeling-prep-mcp-server

Docker — 소스에서 빌드하거나 사전 빌드된 이미지를 가져오기(pull)

Source — 클론(clone) 후 npm install && npm run build로 실행

방법별 상세 단계는 docs/INSTALLATION.md를 참조하세요.

이 서버는 CLI 인자(arguments), 환경 변수(environment variables) 또는 세션 설정을 통해 제어되는 세 가지 운영 모드를 지원합니다:

모드	활성화 방법	설명
Dynamic (동적)	DYNAMIC_TOOL_DISCOVERY=true	5개의 메타 도구로 시작하며, 런타임에 도구 세트를 로드함
Static (정적)	FMP_TOOL_SETS=search,company	세션 생성 시 지정된 도구 세트를 사전 로드함
All Tools (모든 도구, 기본값)	(기본값)	250개 이상의 모든 도구를 즉시 로드함

우선순위: CLI 인자 > 환경 변수 > 세션 설정 > 기본값.

전체 설정 참조는 docs/CONFIGURATION.md를 확인하세요.

HTTP/SSE 전송(transport)을 통해 서버에 연결하세요:

Claude.ai / Claude Desktop— 원격 커넥터로 추가 (Settings > Connectors)
Custom clients— mcp-client-id 헤더를 포함하여 /mcp로 POST 요청
MCP registries— Smithery.ai, Glama.ai 및 기타

클라이언트별 설정, 세션 헤더 및 요청 예시는 docs/USAGE.md를 참조하세요.

다음 24개 카테고리를 포함합니다:

검색 · 디렉토리 및 심볼 목록 · 기업 정보 · 재무제제표 · 재무 지표 및 분석 · 기술적 지표 · 시세 및 가격 데이터 · 시장 지수 및 성과 · 시장 데이터 · 뉴스 및 보도 자료 · SEC 공시 · 내부자 및 기관 거래 · ETF 및 펀드 · 정부 거래 · 암호화폐 및 외환 · 실적 · 특수 데이터 세트 · 원자재 · 경제 · 벌크 데이터 도구

전체 도구 카탈로그는 docs/API_REFERENCE.md를 참조하세요.

이 서버는 쉬운 검색을 위해 여러 MCP 레지스트리(registries)에 등록되어 있습니다:

레지스트리별 설정 지침은 docs/REGISTRIES.md를 참조하세요.

기여(Contributions)를 환영합니다. 개발 설정, 테스트 및 풀 리퀘스트(pull request) 가이드라인은 CONTRIBUTING.md를 참조하세요.