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) 또는 세션 설정을 통해 제어되는 세 가지 운영 모드를 지원합니다:

우선순위: 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를 참조하세요.