Skip to main content
Glama
Financial Modeling Prep (FMP) MCP Server

Financial Modeling Prep (FMP) MCP Server

by jackdark425

Financial Modeling Prep MCP 서버

License: MIT Node.js MCP SDK Version

최신 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 엔드포인트에 매핑됩니다. 공식 문서를 참조하십시오:

감사의 말

참조 프로젝트

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

라이선스 및 사용

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

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

참고:

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

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

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

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

지원

Available Tools

26 tools
get_analyst_estimatesB

Get analyst financial estimates for a stock (revenue, EPS forecasts)

Inputs: symbol (required), period, limit.

get_analyst_ratingsB

Get analyst ratings and upgrades/downgrades for a stock

Inputs: symbol (required).

get_balance_sheetB

Get company balance sheet statement (annual or quarterly)

Inputs: symbol (required), period, limit.

get_cash_flowC

Get company cash flow statement (annual or quarterly)

Inputs: symbol (required), period, limit.

get_company_profileB

Get detailed company profile information including description, industry, sector, CEO, and more

Inputs: symbol (required).

get_earnings_calendarB

Get upcoming earnings announcements calendar

Inputs: from, to.

get_economic_calendarC

Get upcoming economic data releases calendar

Inputs: from, to.

get_economic_indicatorC

Get economic indicator data (GDP, unemployment, inflation, etc.)

Inputs: name (required), from, to.

get_financial_ratiosB

Get detailed financial ratios (profitability, liquidity, efficiency)

Inputs: symbol (required), period, limit.

get_historical_chartC

Get historical price data with flexible time intervals

Inputs: symbol (required), interval (required), from, to.

get_income_statementC

Get company income statement (annual or quarterly)

Inputs: symbol (required), period, limit.

get_insider_tradingC

Get recent insider trading activity for a stock

Inputs: symbol (required), limit.

get_institutional_holdersC

Get institutional ownership (13F filings) for a stock

Inputs: symbol (required), limit.

get_key_metricsB

Get key financial metrics (P/E, ROE, debt ratios, etc.)

Inputs: symbol (required), period, limit.

get_market_gainersB

Get stocks with the largest price increases (top gainers)

Inputs: no named parameters.

get_market_losersB

Get stocks with the largest price drops (top losers)

Inputs: no named parameters.

get_most_activeB

Get most actively traded stocks by volume

Inputs: no named parameters.

get_price_targetB

Get analyst price target summary for a stock

Inputs: symbol (required).

get_quoteA

Get real-time stock quote for a symbol (e.g., AAPL, TSLA, MSFT)

Inputs: symbol (required).

get_sector_performanceC

Get current sector performance snapshot

Inputs: date.

get_sp500_constituentsB

Get list of S&P 500 index constituents

Inputs: no named parameters.

get_stock_newsC

Get latest news articles for a stock symbol

Inputs: symbol (required), limit.

get_technical_indicator_emaC

Get Exponential Moving Average (EMA) technical indicator

Inputs: symbol (required), timeframe (required), period.

get_technical_indicator_rsiC

Get Relative Strength Index (RSI) technical indicator

Inputs: symbol (required), timeframe (required), period.

get_technical_indicator_smaC

Get Simple Moving Average (SMA) technical indicator

Inputs: symbol (required), timeframe (required), period.

search_symbolC

Search for stock symbols by company name or ticker

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 26 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes targeting specific financial data categories (e.g., financial statements, market data, analyst information). However, some potential overlap exists between get_financial_ratios and get_key_metrics, and among the three technical indicator tools (EMA, RSI, SMA) which might cause minor confusion about which specific indicator is needed.

    Naming Consistency5/5

    Excellent naming consistency with a uniform get_* pattern throughout all 26 tools. The naming follows a clear verb_noun structure where 'get' is the consistent verb followed by descriptive nouns that clearly indicate the data being retrieved.

    Tool Count3/5

    26 tools is borderline heavy for a financial data server. While comprehensive coverage is valuable, this many tools might overwhelm agents and could potentially be consolidated (e.g., technical indicators could be combined into a single parameterized tool). The count suggests good breadth but questionable depth optimization.

    Completeness5/5

    Extremely comprehensive coverage of financial data domains including fundamental analysis (statements, ratios, metrics), market data (quotes, gainers/losers), analyst information (estimates, ratings), economic data, and technical indicators. No obvious gaps exist for a financial data provider server.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides tools for financial analysis using the Financial Modelling Prep API. It enables users to retrieve real-time stock quotes, financial statements, valuation metrics, and sector performance data for investment research.
      -
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An MCP server that provides tools for financial analysis and investment research using the Financial Modelling Prep API. It enables users to access real-time stock quotes, financial statements, key metrics, and market sector performance data.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A specialized MCP server that provides institutional-grade financial data and market research via the Finnhub API. It enables AI agents to function as equity researchers, generating professional market reports and high-fidelity analysis for stock tickers.
      ISC
    • A
      license
      Not graded
      quality
      C
      maintenance
      A Model Context Protocol (MCP) server that provides tools, resources, and prompts for financial analysis using the Financial Modeling Prep API.
      51
      MIT