Finance Tools MCP
finance-tools-mcp: 재무 분석 MCP 서버
개요
finance-tools-mcp는 대규모 언어 모델(LLM)에 포괄적인 재무 통찰력과 분석 기능을 제공하도록 설계된 모델 컨텍스트 프로토콜(MCP) 서버입니다. investor-agent 에서 수정된 이 서버는 다양한 데이터 소스 및 분석 라이브러리와 통합되어 상세한 재무 조사 및 분석을 위한 도구 모음을 제공합니다.
Related MCP server: Trading MCP Server
제공되는 도구
서버는 MCP를 통해 다양한 도구를 제공하여 연결된 클라이언트(LLM 등)가 특정 재무 데이터에 액세스하고 분석을 수행할 수 있도록 합니다.
티커 데이터 도구:
get_ticker_data: 개요, 뉴스, 주요 지표, 성과, 날짜, 분석가 추천, 업그레이드/다운그레이드 등을 포함하여 특정 티커에 대한 포괄적인 보고서를 제공합니다.get_options: 날짜 범위, 행사 가격, 옵션 유형(콜/풋)에 대한 필터링 옵션을 사용하여 티커에 대한 가장 높은 미결제 약정이 있는 옵션 데이터를 검색합니다.get_price_history: OHLCV 샘플, 기술 지표, 위험 지표 및 기타 양적 분석을 포함하여 특정 기간 동안의 과거 가격 데이터 다이제스트를 가져옵니다.get_financial_statements: 분기별 또는 연간으로 제공되는 티커의 재무 제표(수입, 잔액, 현금 흐름)에 액세스합니다.get_institutional_holders: 티커에 대한 주요 기관 및 뮤추얼 펀드 보유자를 나열합니다.get_earnings_history: 티커에 대한 추정치와 예상치를 포함한 수익 내역을 제공합니다.get_insider_trades: 티커의 최근 내부자 거래 활동을 검색합니다.get_ticker_news_tool: 특정 티커에 대한 최신 Yahoo Finance 뉴스를 가져옵니다.
두려움과 탐욕 지수 도구:
get_current_fng_tool: 현재 CNN 공포 & 탐욕 지수 점수와 평점을 가져옵니다.get_historical_fng_tool: 지정된 일수 동안의 과거 CNN 공포 및 탐욕 지수 데이터를 검색합니다.analyze_fng_trend: 특정 기간 동안 CNN 공포 & 탐욕 지수의 추세를 분석합니다.
계산 도구:
calculate: Python의 수학 구문과 NumPy를 사용하여 수학 표현식을 평가합니다.
매크로 데이터 도구:
get_current_time: 현재 시간을 제공합니다.get_fred_series: 특정 FRED 시리즈 ID에 대한 데이터를 검색합니다.search_fred_series: 키워드로 인기 있는 FRED 시리즈를 검색합니다.cnbc_news_feed: CNBC, BBC, SCMP에서 최신 세계 뉴스를 가져옵니다.
시계열 데이터 처리 및 최적화
이 서버는 yfinance 활용하여 티커의 과거 가격 데이터(OHLCV - 시가, 고가, 저가, 종가, 거래량)를 검색합니다. 이 원시 데이터는 상당한 처리 및 분석을 거쳐 LLM의 활용에 최적화된 귀중한 통찰력을 제공합니다.
시계열 데이터 처리의 주요 측면은 다음과 같습니다.
종합 분석:
ta-lib-python과 같은 라이브러리를 사용하여 데이터를 분석하여 다양한 기술 지표를 계산합니다. 또한, 사용자 정의 함수를 사용하여 기본 통계, 위험 지표를 계산하고, 일반적인 차트 패턴을 인식하고, 피보나치 되돌림 수준을 계산합니다.구조화된 다이제스트: 이 분석의 결과는 LLM이 쉽게 분석하고 이해할 수 있는 구조화된 다이제스트 형식(
generate_time_series_digest_for_LLM)으로 컴파일되며, 여기에는 통계, 요약, 기술 지표, 위험 지표, 패턴, 피보나치 수준 및 데이터 샘플에 대한 섹션이 포함됩니다.LLM을 위한 스마트 샘플링: LLM에게 맥락적 제약 없이 과거 데이터에 대한 대표성을 제공하기 위해 "스마트 샘플링" 전략(
get_latest_data_sample)을 사용합니다. 이 방법은 다양한 해상도로 데이터를 샘플링합니다.고해상도: 최신 데이터 포인트가 매일 포함됩니다.
중간 해상도: 중간 수준의 데이터 포인트가 매주 샘플링됩니다.
저해상도: 오래된 데이터 포인트는 매월 샘플링됩니다. 이러한 하이브리드 방식을 통해 LLM은 관리 가능한 수의 데이터 포인트 내에서 최근 가격 변동에 대한 자세한 정보를 얻는 동시에 장기적인 추세에 대한 맥락도 파악할 수 있습니다.
시계열 데이터의 최적화된 처리 및 표현을 통해 LLM은 주요 추세, 지표 및 패턴을 빠르게 파악하여 더욱 정보에 입각한 재무 분석을 수행할 수 있습니다.
샘플 보고서

필수 조건
Python: 3.10 이상
패키지 관리자: uv
설치
먼저, 아직 uv를 설치하지 않았다면 설치하세요.
지엑스피1
그런 다음 uvx 사용하여 finance-tools-mcp MCP 서버를 실행할 수 있습니다.
uvx finance-tools-mcp자신의 FRED API 키를 사용하려면 환경 변수로 설정할 수 있습니다.
FRED_API_KEY=YOUR_API_KEY uvx finance-tools-mcpSSE(Server-Sent Events) 전송을 사용하여 서버를 실행할 수도 있습니다.
uvx finance-tools-mcp --transport sse또는 FRED API 키와 SSE 전송을 사용하면:
FRED_API_KEY=YOUR_API_KEY uvx finance-tools-mcp --transport sseMCP 클라이언트와 함께 사용
finance-tools-mcp를 MCP 클라이언트(예: Claude Desktop)와 통합하려면 claude_desktop_config.json 에 다음 구성을 추가합니다.
{
"mcpServers": {
"investor": {
"command": "path/to/uvx/command/uvx",
"args": ["finance-tools-mcp"],
}
}
}디버깅
MCP 검사기를 활용하여 서버를 디버깅할 수 있습니다.
npx @modelcontextprotocol/inspector uvx finance-tools-mcp또는
npx @modelcontextprotocol/inspector uv --directory ./ run finance-tools-mcp로그 모니터링을 위해 다음 디렉토리를 확인하세요.
macOS:
~/Library/Logs/Claude/mcp*.logWindows:
%APPDATA%\Claude\logs\mcp*.log
개발
로컬 개발 및 테스트를 위해:
디버깅 섹션에 설명된 대로 MCP 검사기를 사용하세요.
다음 구성으로 Claude Desktop을 사용하여 테스트해 보세요.
{
"mcpServers": {
"investor": {
"command": "path/to/uv/command/uv",
"args": ["--directory", "path/to/finance-tools-mcp", "run", "finance-tools-mcp"],
}
}
}특허
이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.
샘플
할 일
[ ] 주식에 대한 지지 수준과 저항 수준을 추가합니다.
[x] 주식에 대한 피보나치 수정 수준 추가
[ ] 주식에 대한 이동 평균 합류 수준 추가
[ ] 예측을 위한 옵션 모델 추가
[ ] 재무 시트 및 기타 기능을 사용하여 예측 모델 추가
데이터 소스
핀텔닷컴
인베스팅닷컴
야후닷컴
fred.stlouisfed.org
CNN, CNBC, 레딧
Available Tools
17 toolsanalyze_fng_trendA
Analyze trends in CNN Fear & Greed Index over specified days.
Parameters:
days (int): Number of days to analyze (limited by available data).
Returns:
str: A string containing the analysis results, including latest value,
average value, trend direction, and number of data points analyzed.
Inputs: days (required).
calculateB
Calculate the result of a mathematical expression. Support python math syntax and numpy. > calculate("2 * 3 + 4") {'result': 10} > calculate("sin(pi/2)") {'result': 1.0} > calculate("sqrt(16)") {'result': 4.0} > calculate("np.mean([1, 2, 3])") {'result': 2.0}
Inputs: expression (required).
cnbc_news_feedB
Get the latest breaking world news from CNBC, BBC, and SCMP. Useful to have an overview for the day. Include the Fed rate prediction from Fed watch and key macro indicators.
Inputs: no named parameters.
get_current_timeA
Get the current time in ISO 8601 format.
Inputs: no named parameters.
get_earnings_historyC
Get earnings history with estimates and surprises.
Inputs: ticker (required).
get_financial_statementsC
Get financial statements. Types: income, balance, cash. Frequency: quarterly, annual.
Inputs: ticker (required), frequency, statement_type.
get_fred_seriesB
Get a FRED series by its ID. However the data is not always the latest, so use with caution!!!
Inputs: series_id (required).
get_historical_fng_toolB
Get historical CNN Fear & Greed Index data for a specified number of days.
Parameters:
days (int): Number of days of historical data to retrieve (limited by the API).
Returns:
str: Historical Fear & Greed Index values for the specified period.
Inputs: days (required).
get_insider_tradesC
Get recent insider trading activity.
Inputs: ticker (required).
get_overall_sentiment_toolB
Get comprehensive market sentiment indicators including:
- CNN Fear & Greed Index (score and rating)
- Market RSI (Relative Strength Index)
- VIX (Volatility Index)
Returns:
str: Formatted string containing all three indicators with their current values
Inputs: no named parameters.
get_price_historyA
Get historical price data digest for specified period. There're two kinds of response mode: 1. The period mode. It will generate a digest for LLM consumption. Usually get at least 3 months, 6 months or more. The response includes OCHLCV samples, Technical Indicators (by ta-lib) , Risk Metrics, and other quantitative analysis. 2. The start_date and end_date mode. Once the start_date (yyyy-mm-dd) and end_date (yyyy-mm-dd) are specified, it will generate a raw OCHLCV data in the slot. And no digest will be generated in this mode. Useful for checking the price history of a specific short date range.
Inputs: ticker (required), end_date, period, start_date.
get_ticker_dataB
Get comprehensive report for ticker: overview, news, metrics, sector / industry valuation, performance, dates, analyst recommendations, and upgrades/downgrades.
Inputs: ticker (required).
get_ticker_news_toolB
For getting yahoo financial news of a ticker. Useful for getting latest news, especially for doing deep research.
Inputs: ticker (required).
get_top25_holdersC
Get top 25 institutional holders and their changes for a given stock ticker.
Inputs: ticker (required).
search_fred_seriesC
Search for the most popular FRED series by keyword. Useful for finding key data by name. Like GDP, CPI, etc. However the data is not always the latest.
Inputs: query (required).
super_option_toolB
Analyzes and summarizes option data for a given ticker.
This function retrieves option indicators and Greeks for the specified ticker,
generates a digest summarizing key metrics, and formats a table of key option
data including last trade date, strike, option type, open interest, volume,
and implied volatility.
Args:
ticker: Stock ticker symbol.Inputs: ticker (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Most tools have distinct purposes, but there is some overlap that could cause confusion. For example, get_historical_fng_tool and analyze_fng_trend both deal with Fear & Greed Index data, and get_ticker_data includes news while get_ticker_news_tool is specifically for news. However, descriptions help clarify differences, such as analyze_fng_trend focusing on trend analysis versus get_historical_fng_tool for raw data retrieval.
The naming follows a consistent snake_case pattern with a verb_noun structure for most tools, like get_price_history and search_fred_series. There are minor deviations, such as calculate being a single verb and cnbc_news_feed using a noun_verb_noun pattern, but overall, the naming is predictable and readable.
With 17 tools, the count is slightly high but reasonable for a finance domain that covers diverse areas like market data, news, sentiment, and analysis. It provides comprehensive coverage without being overwhelmingly large, though it borders on the heavy side for typical MCP server scopes.
The tool set offers broad coverage for financial analysis, including data retrieval (e.g., price history, financial statements), sentiment indicators, news feeds, and specialized tools like options analysis. Minor gaps exist, such as no explicit tools for portfolio management or trading actions, but agents can work around this with the available tools for core financial workflows.
Maintenance
Related MCP Connectors
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
MCP server for Financial Modeling Prep API with 250+ financial data tools
Official Score VI MCP server: intrinsic value, fundamentals, and a stock screener.
101The 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.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that provides comprehensive access to real-time stock quotes, financial statements, analyst estimates, and technical indicators via the Financial Modeling Prep API. It enables users to conduct in-depth financial analysis and track market performance through specialized tools, resources, and prompt templates.2647 npm1MIT
- AlicenseAqualityDmaintenanceA comprehensive MCP server for stock analysis and trading insights, including stock screening, fundamental analysis, insider trading, options analysis, social media research, and news analysis.1075MIT
- AlicenseAqualityCmaintenanceComprehensive MCP server for real-time stock, cryptocurrency, options, and fundamental analysis, including SEC filings and insider trading data.269 npmMIT
- AlicenseAqualityDmaintenanceAn advanced MCP server for real-time worldwide stock market data, technical indicators, financials, news, and Python sandboxing with AI models, supporting US and Indian markets.291MIT
social_media_feedA
Get most discussed stocks and investments opinions from reddit. Useful to know what investors are talking about. keywords is optional. Set keywords to match the specific topic you are interested in, by 'OR' operator, e.g. ['tsla', 'tesla'], ['tesla', 'spacex'], ['AAPL', 'apple', 'tim cook', 'cook'] No keywords will return the most discussed stocks and investments.
Inputs: keywords.