fintools-mcp

MCP(Model Context Protocol)를 통한 AI 어시스턴트용 금융 분석 도구입니다.

Claude, ChatGPT, Cursor 또는 MCP 호환 AI에게 단순한 주가 정보를 넘어 트레이더가 실제로 사용하는 분석 툴킷을 제공하여 실질적인 금융 분석 기능을 부여하세요.

도구

도구	기능
`get_technical_indicators`	RSI, MACD, ATR, EMA(9/21/50/200), 피보나치 레벨, 추세 평가
`get_stock_quote`	현재가, 거래량, 52주 범위, 시가총액
`get_trend_score`	-100(강한 하락세)에서 +100(강한 상승세)까지의 추세 점수 및 구성 요소 분석
`get_support_resistance`	터치 횟수 및 강도 등급을 포함한 주요 지지/저항 레벨
`screen_stocks`	RSI, 추세 점수, EMA 위치, 상대 거래량으로 S&P 500 종목 스크리닝 — 빠른 셋업 탐색
`analyze_options_chain`	IV 분석, 유동성 필터링, 풋/콜 비율을 포함한 옵션 체인
`calculate_position_size`	손절매 및 목표 수익가를 고려한 위험 기반 포지션 사이징
`calculate_atr_position`	ATR 기반 포지션 사이징 — 변동성을 바탕으로 손절가 및 목표가 자동 계산
`analyze_trades`	거래 손익(P&L)을 바탕으로 승률, 수익률, 샤프 지수, 낙폭, 연속 기록 분석
`compare_tickers`	여러 심볼에 대한 기술적 비교

작동 방식

fintools-mcp 시퀀스 다이어그램

빠른 시작

설치

pip install fintools-mcp

또는 uv 사용 시:

uv pip install fintools-mcp

Claude Desktop에 추가

~/Library/Application Support/Claude/claude_desktop_config.json 파일을 수정하세요:

{
  "mcpServers": {
    "fintools": {
      "command": "uv",
      "args": ["run", "--from", "fintools-mcp", "fintools-mcp"]
    }
  }
}

또는 pip를 통해 설치한 경우:

{
  "mcpServers": {
    "fintools": {
      "command": "fintools-mcp"
    }
  }
}

Claude Code에 추가

claude mcp add fintools -- uv run --from fintools-mcp fintools-mcp

예시

설정이 완료되면 AI 어시스턴트에게 다음과 같이 질문할 수 있습니다:

"200 EMA 위에 있으면서 과매도 상태인 S&P 500 종목을 찾아줘"
"SPY의 추세 점수는 뭐야?"
"NVDA의 지지 및 저항 레벨을 보여줘"
"현재 AAPL의 기술적 셋업은 어때?"
"다음 주 금요일 만기인 SPY 옵션 체인을 분석해줘"
"10만 달러 계좌로 1.5% 위험을 감수하고 NVDA를 매수하려고 해. 몇 주를 사야 하고 손절가는 어디로 잡아야 할까?"
"AAPL, GOOGL, MSFT, AMZN을 비교해서 가장 강한 추세를 보이는 종목은 뭐야?"
"내 최근 거래 20개는 다음과 같아: [150, -80, 200, ...] — 내 승률과 샤프 지수는 얼마야?"

출력 예시

기술적 지표

> "What's the technical setup on SPY?"

SPY @ $573.42
  RSI(14): 58.3 — bullish momentum
  MACD: 2.14 (histogram +0.38, bullish)
  ATR(14): $7.82
  EMAs: 9 > 21 > 50 > 200 (fully stacked bullish)
  Fibonacci: In golden pocket (0.618-0.65 retracement)
  Trend: Bullish (all signals aligned)

포지션 사이징

> "Size a long position on AAPL at $227, stop $220, target $245"

  Shares: 214
  Position value: $48,578
  Risk: $1,498 (1.5% of $100k)
  Reward: $3,852
  R:R ratio: 2.57

아키텍처

fintools-mcp/
├── fintools_mcp/
│   ├── server.py              # MCP server — tool definitions
│   ├── data.py                # Market data via yfinance
│   ├── indicators/            # Technical indicators (standalone, no deps)
│   │   ├── rsi.py             # RSI — Wilder's smoothing
│   │   ├── macd.py            # MACD (12, 26, 9)
│   │   ├── atr.py             # ATR — Average True Range
│   │   ├── ema.py             # EMA — any period
│   │   ├── vwap.py            # VWAP — intraday, daily reset
│   │   └── fibonacci.py       # Fibonacci retracement + golden pocket
│   └── analysis/
│       ├── position_sizer.py  # Risk-based + ATR-based sizing
│       └── trade_stats.py     # KPI calculator (60+ metrics)
└── tests/

데이터 소스

주식 데이터: Yahoo Finance (무료, API 키 불필요)
옵션 데이터: Yahoo Finance 옵션 체인
기본 기능 사용 시 API 키가 필요하지 않습니다.

개발

git clone https://github.com/slimbiggins007/fintools-mcp.git
cd fintools-mcp
uv sync
uv run python -m fintools_mcp  # starts the MCP server

테스트 실행:

uv run pytest

라이선스

MIT

fintools-mcp

fintools-mcp

도구

작동 방식

빠른 시작

설치

Claude Desktop에 추가

Claude Code에 추가

예시

출력 예시

기술적 지표

포지션 사이징

아키텍처

데이터 소스

개발

라이선스

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API