Financial Modeling Prep MCP 서버

최신 MCP SDK 도구/리소스/프롬프트 모델로 구축된 Financial Modeling Prep (FMP) 시장 데이터용 MCP 서버입니다.

개요

aigroup-fmp-mcp는 Financial Modeling Prep API를 통해 다음과 같은 기능을 위한 구조화된 MCP 인터페이스를 제공합니다:

• 실시간 시세 및 심볼 조회

• 기업 프로필 및 재무제표

• 애널리스트 추정치 및 등급

• 기술적 지표 및 과거 차트

• 실적 발표 / 경제 캘린더 워크플로우

• 분석 작업을 위한 재사용 가능한 MCP 리소스 및 프롬프트

Related MCP server: FMP MCP Server

주요 특징

• 시장 데이터, 재무, 애널리스트 워크플로우, 기술적 지표 및 캘린더 데이터를 다루는 25개의 MCP 도구

• 직접적인 URI 기반 액세스 패턴을 위한 리소스 지원

• 주식 분석, 포트폴리오 검토 및 실적 발표 미리보기를 위한 프롬프트 템플릿

• 선택적 HTTP 상태/정보 엔드포인트를 포함한 전체 stdio MCP 지원

• 더 안전한 입력 처리를 위한 Zod 유효성 검사

• 최신 McpServer API를 사용한 MCP SDK 1.27.1 기반 구축

빠른 시작

요구 사항

• Node.js >= 18

• npm

• 유효한 FMP API 키

로컬 소스로 실행

git clone https://github.com/jackdark425/aigroup-fmp-mcp.git
cd aigroup-fmp-mcp
npm install
npm run build
export FMP_API_KEY="your-api-key"
npm start

HTTP 모드

export FMP_API_KEY="your-api-key"
npm run start:http

기본적으로 HTTP 서버는 다음을 노출합니다:

• POST /mcp — 이 빌드에서는 501을 반환합니다

• GET /health — 상태 확인

• GET / — 서버 정보

현재 빌드의 HTTP 모드는 상태 확인 및 서비스 메타데이터 전용입니다. MCP 도구, 리소스 및 프롬프트에는 stdio 모드를 사용하십시오.

구성

서버를 시작하기 전에 API 키를 설정하십시오:

export FMP_API_KEY="your-api-key"

Financial Modeling Prep에서 키를 받으십시오.

MCP 클라이언트 구성

Claude Desktop / 호환 MCP 클라이언트

{
  "mcpServers": {
    "fmp": {
      "command": "node",
      "args": ["/path/to/aigroup-fmp-mcp/build/index.js"],
      "env": {
        "FMP_API_KEY": "your-api-key"
      }
    }
  }
}

도구

시장 데이터

• get_quote

• search_symbol

• get_market_gainers

• get_market_losers

• get_most_active

• get_sector_performance

• get_sp500_constituents

재무제표

• get_company_profile

• get_income_statement

• get_balance_sheet

• get_cash_flow

• get_stock_news

• get_key_metrics

• get_financial_ratios

애널리스트 데이터

• get_analyst_estimates

• get_price_target

• get_analyst_ratings

• get_insider_trading

• get_institutional_holders

기술적 지표

• get_technical_indicator_rsi

• get_technical_indicator_sma

• get_technical_indicator_ema

• get_historical_chart

캘린더 데이터

• get_earnings_calendar

• get_economic_calendar

• get_economic_indicator

리소스

• fmp://company/{symbol}/profile

• fmp://company/{symbol}/quote

• fmp://company/{symbol}/financials/{statement}/{period}

• fmp://market/overview

• fmp://market/sectors/{date}

프롬프트

• stock_analysis

• portfolio_evaluation

• earnings_preview

프로젝트 구조

aigroup-fmp-mcp/
├── src/
│   ├── index.ts
│   ├── server.ts
│   ├── tools/
│   ├── resources/
│   ├── prompts/
│   ├── types/
│   └── utils/
├── package.json
├── tsconfig.json
└── README.md

개발

npm install
npm run build
npm run dev

API 참조

모든 도구는 FMP 엔드포인트에 매핑됩니다. 공식 문서를 참조하십시오:

• FMP API 문서

감사의 말

참조 프로젝트

• houtini-ai/fmp-mcp

  • 저장소: https://github.com/houtini-ai/fmp-mcp

  • 참조 범위: 전체 프로젝트 방향, MCP 서버 구조 및 기능 구성

이 구현에 도움을 준 houtini-ai의 이전 오픈 소스 작업에 감사드립니다.

라이선스 및 사용

이 프로젝트는 MIT 라이선스 하에 릴리스되었습니다.

원본 저작권 고지 및 라이선스 텍스트가 유지되는 한, 상업적 맥락을 포함하여 이 소프트웨어의 사본을 사용, 복사, 수정, 병합, 게시, 배포, 재라이선스 및 판매할 수 있습니다.

참고:

• 소프트웨어는 어떠한 종류의 보증 없이 "있는 그대로" 제공됩니다.

• 소프트웨어의 사본 또는 상당 부분에 관련 저작권 및 허가 고지를 보존해야 합니다.

• FMP API 사용은 Financial Modeling Prep의 자체 서비스 약관, 할당량, 청구 규칙 및 데이터 사용 제한을 따릅니다.

전체 내용은 LICENSE를 참조하십시오.

지원

• 이슈: https://github.com/jackdark425/aigroup-fmp-mcp/issues

• 저장소: https://github.com/jackdark425/aigroup-fmp-mcp