fintools-mcp

Инструменты финансового анализа для ИИ-ассистентов через MCP (Model Context Protocol).

Предоставьте Claude, ChatGPT, Cursor или любому другому ИИ, совместимому с MCP, доступ к реальному финансовому анализу — не просто к котировкам акций, а к аналитическому инструментарию, который действительно использует трейдер.

Инструменты

Инструмент	Что он делает
`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`	Скрининг акций S&P 500 по RSI, оценке тренда, положению EMA, относительному объему — быстрый поиск сетапов
`analyze_options_chain`	Цепочка опционов с анализом IV, фильтрацией ликвидности, коэффициентами put/call
`calculate_position_size`	Расчет размера позиции на основе риска с учетом стоп-лосса и тейк-профита
`calculate_atr_position`	Расчет размера позиции на основе ATR — автоматический расчет стопа и цели исходя из волатильности
`analyze_trades`	Винрейт, фактор прибыли, коэффициент Шарпа, просадка, серии сделок на основе P&L
`compare_tickers`	Техническое сравнение нескольких символов бок о бок

Как это работает

fintools-mcp sequence diagram

Быстрый старт

Установка

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

Примеры

После настройки вы можете задавать своему ИИ-ассистенту вопросы вроде:

"Найди перепроданные акции S&P 500, которые все еще выше своей 200 EMA"
"Какая оценка тренда у SPY?"
"Покажи уровни поддержки и сопротивления для NVDA"
"Какой сейчас технический сетап по AAPL?"
"Проанализируй цепочку опционов SPY на следующую пятницу"
"Если я хочу открыть длинную позицию по NVDA с депозитом $100k и риском 1.5%, сколько акций купить и где поставить стоп?"
"Сравни 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