Financial Modeling Prep (FMP) MCP Server
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 유효성 검사
최신
McpServerAPI를 사용한 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 startHTTP 모드
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_quotesearch_symbolget_market_gainersget_market_losersget_most_activeget_sector_performanceget_sp500_constituents
재무제표
get_company_profileget_income_statementget_balance_sheetget_cash_flowget_stock_newsget_key_metricsget_financial_ratios
애널리스트 데이터
get_analyst_estimatesget_price_targetget_analyst_ratingsget_insider_tradingget_institutional_holders
기술적 지표
get_technical_indicator_rsiget_technical_indicator_smaget_technical_indicator_emaget_historical_chart
캘린더 데이터
get_earnings_calendarget_economic_calendarget_economic_indicator
리소스
fmp://company/{symbol}/profilefmp://company/{symbol}/quotefmp://company/{symbol}/financials/{statement}/{period}fmp://market/overviewfmp://market/sectors/{date}
프롬프트
stock_analysisportfolio_evaluationearnings_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 devAPI 참조
모든 도구는 FMP 엔드포인트에 매핑됩니다. 공식 문서를 참조하십시오:
감사의 말
참조 프로젝트
houtini-ai/fmp-mcp
참조 범위: 전체 프로젝트 방향, MCP 서버 구조 및 기능 구성
이 구현에 도움을 준 houtini-ai의 이전 오픈 소스 작업에 감사드립니다.
라이선스 및 사용
이 프로젝트는 MIT 라이선스 하에 릴리스되었습니다.
원본 저작권 고지 및 라이선스 텍스트가 유지되는 한, 상업적 맥락을 포함하여 이 소프트웨어의 사본을 사용, 복사, 수정, 병합, 게시, 배포, 재라이선스 및 판매할 수 있습니다.
참고:
소프트웨어는 어떠한 종류의 보증 없이 "있는 그대로" 제공됩니다.
소프트웨어의 사본 또는 상당 부분에 관련 저작권 및 허가 고지를 보존해야 합니다.
FMP API 사용은 Financial Modeling Prep의 자체 서비스 약관, 할당량, 청구 규칙 및 데이터 사용 제한을 따릅니다.
전체 내용은 LICENSE를 참조하십시오.
지원
Available Tools
26 toolsget_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
Scored across 26 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for Financial Modeling Prep API with 250+ financial data tools
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
The Octagon MCP server provides specialized AI-powered financial research and analysis by integrating with the Octagon Market Intelligence API. It enables users to analyze public market data (SEC filings, earnings transcripts, financial metrics, and stock data for 8000+ companies), private market data (3M+ companies, 500k+ funding rounds, 2M+ M&A/IPO transactions), and conduct deep research including web scraping capabilities. The server also features autonomous research agents that search hundreds of sources and return fully cited reports in approximately one minute.
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn 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.-
- AlicenseNot gradedqualityNot gradedmaintenanceAn 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
- AlicenseNot gradedqualityDmaintenanceA 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
- AlicenseNot gradedqualityCmaintenanceA Model Context Protocol (MCP) server that provides tools, resources, and prompts for financial analysis using the Financial Modeling Prep API.51MIT