MCP-сервер QuantData

ЭТО НЕОФИЦИАЛЬНЫЙ MCP-СЕРВЕР, Я НИКАК НЕ СВЯЗАН С QUANTDATA

MCP-сервер, который предоставляет ИИ-агентам (Claude Code, Claude Desktop и др.) доступ к рыночным данным по опционам в реальном времени и историческим данным от QuantData.

📖 Новичок? Начните с Руководства по началу работы для пошагового ознакомления.

Поддерживает любой тикер с опционами — SPX, SPY, QQQ, AAPL, TSLA и другие. Не только 0DTE.

Доступные данные: уровни экспозиции GEX/DEX/CEX/VEX, временная структура экспозиции, чистый дрейф, «максимальная боль», IV rank, статистика торговых сторон, открытый интерес, чистый поток, консолидированный поток ордеров, OHLCV контрактов и статистика контрактов.

Документация: см. GETTING_STARTED.md для пошагового руководства.

Related MCP server: traders-edge-mcp

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

1. Установка

Вам потребуется установленный Python 3.11+. Проверьте версию командой python3 --version.

• Mac: brew install python (или скачайте с python.org)

• Windows: Скачайте с python.org (отметьте «Add to PATH» при установке)

Установите из PyPI:

# With pip
pip install quantdata-mcp

# With uv (faster)
uv pip install quantdata-mcp

# Or install as a global tool with uv
uv tool install quantdata-mcp

Нет uv? Установите его с помощью curl -LsSf https://astral.sh/uv/install.sh | sh (Mac/Linux) или irm https://astral.sh/uv/install.ps1 | iex (Windows). Это более быстрая альтернатива pip.

Хотите самую свежую версию? Установите из GitHub: pip install git+https://github.com/zzulanas/quantdata-mcp.git

2. Получение учетных данных

Вам понадобятся два значения из вашей учетной записи QuantData. Откройте браузер:

1. Перейдите на v3.quantdata.us и войдите в систему

2. Откройте DevTools (F12 или правая кнопка мыши → Просмотреть код) → вкладка Network

3. Обновите страницу

4. Нажмите на любой график или страницу в QuantData — вы увидите API-запросы

5. Нажмите на любой запрос к core-lb-prod.quantdata.us или отфильтруйте по /api вверху

6. В Request Headers найдите и скопируйте:

   • authorization — ваш токен авторизации (начинается с eyJ...)

   • x-instance-id — ваш ID экземпляра (UUID, например xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

Это должно выглядеть так:

3. Запуск настройки

quantdata-mcp setup \
  --auth-token "eyJhbGci..." \
  --instance-id "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Это создаст выделенную страницу в вашей учетной записи QuantData с 11 инструментами данных и сохранит вашу конфигурацию в ~/.quantdata-mcp/config.json.

4. Добавление в Claude

Claude Code

Добавьте в .mcp.json вашего проекта (или глобальный ~/.claude/mcp.json):

{
  "mcpServers": {
    "quantdata": {
      "command": "quantdata-mcp",
      "args": ["serve"]
    }
  }
}

Перезапустите Claude Code. Вы должны увидеть quantdata в своих MCP-серверах.

Claude Desktop

Добавьте в файл конфигурации Claude Desktop:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quantdata": {
      "command": "quantdata-mcp",
      "args": ["serve"]
    }
  }
}

Примечание: quantdata-mcp должен быть в системном PATH. Если он не найден, используйте полный путь:

which quantdata-mcp   # find the path

{ "command": "/Users/you/.local/bin/quantdata-mcp", "args": ["serve"] }

Или используйте uvx для запуска, не беспокоясь о PATH:

{
  "command": "uvx",
  "args": ["--from", "git+https://github.com/zzulanas/quantdata-mcp.git", "quantdata-mcp", "serve"]
}

Перезапустите Claude Desktop. Инструменты QuantData появятся в вашем списке инструментов.

Доступные инструменты

Обзор рынка

Экспозиция (Греки)

Поток премий

Поток ордеров и торговая статистика

Волатильность и ценообразование

Открытый интерес и «максимальная боль»

Общие параметры

Все инструменты принимают эти параметры для управления тикером/датой:

Параметры фильтрации

Инструменты, поддерживающие фильтрацию, принимают эти необязательные параметры:

Примеры использования

Спрашивайте Claude о чем-то вроде:

• "Какие сейчас самые большие уровни GEX?"

• "Покажи мне вчерашние уровни DEX в 10:30 утра"

• "Выведи статистику торговых сторон — сегодня агрессивнее путы или коллы?"

• "Сравни профиль GEX на открытии и закрытии в прошлый четверг"

• "Покажи гамма-экспозицию AAPL для месячной экспирации 17 апреля"

• "Какой чистый дрейф только OTM для SPX сегодня?"

• "Покажи поток ордеров — только коллы с премией более $50K"

• "Получи OHLCV для колла SPX 6600 сегодня"

• "Какой IV rank с периодом 30 дней?"

• "Покажи временную структуру GEX по всем экспирациям"

Поддержка нескольких тикеров

Все инструменты работают с любым тикером, имеющим опционы. Просто передайте ticker="AAPL" (или любой другой символ).

Важно: SPX, SPY и QQQ имеют ежедневные экспирации (0DTE работает по умолчанию). Для опционов на акции, такие как AAPL или TSLA, вы должны установить expiration_date на действительную дату экспирации (например, 3-я пятница месяца), иначе вы получите пустые данные.

> Show me TSLA GEX walls for the April 17 monthly
> qd_get_exposure_by_strike(ticker="TSLA", expiration_date="2026-04-17")

Исторические данные

Все инструменты поддерживают исторический анализ. Либо передайте date= в любой инструмент, либо используйте qd_set_page_date для переключения контекста:

> Set the date to 2026-03-26 and show me the GEX walls at 10:00 AM

> qd_set_page_date(date="2026-03-26")
> qd_get_exposure_by_strike(greek_type="GAMMA", time_minutes=600)

Настройка времени: time_minutes = минуты от полуночи (570 = 9:30 утра, 720 = 12:00 дня, 960 = 4:00 вечера).

Примечание: date должна быть действительным торговым днем (не выходные и не рыночные праздники).

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

У QuantData нет официального API. Этот сервер использует реверс-инжиниринг REST-эндпоинтов их веб-приложения. У каждого пользователя есть «инструменты» (виджеты графиков) на «страницах» — команда настройки создает выделенную страницу со всеми 11 типами данных, чтобы MCP-сервер мог их запрашивать.

Архитектура:

Claude --> MCP (stdio) --> quantdata-mcp server --> QuantData REST API

Ваши учетные данные и ID инструментов хранятся локально в ~/.quantdata-mcp/config.json.

Команды

quantdata-mcp setup --auth-token <TOKEN> --instance-id <ID>  # One-time setup
quantdata-mcp serve                                           # Start MCP server (used by Claude)

Требования

• Python 3.11+

• Активная подписка QuantData

Устранение неполадок

Ошибка "Config not found": Сначала запустите quantdata-mcp setup.

Ошибки авторизации (401): Ваш токен истек. Получите новый на вкладке Network и перезапустите настройку. Ваша существующая страница и инструменты будут использованы повторно:

quantdata-mcp setup --auth-token "NEW_TOKEN" --instance-id "SAME_ID"

Пустые данные: Убедитесь, что у вас есть активная подписка QuantData и рынок был открыт в запрашиваемую дату. Для тикеров, не являющихся индексами (AAPL, TSLA), убедитесь, что вы установили expiration_date на действительную экспирацию опционов.

"No such file or directory" в Claude Desktop: Используйте полный путь к quantdata-mcp (см. шаг 4 выше).

Вклад в проект

Приветствуются любые вклады — отчеты об ошибках, новые инструменты, обертывающие дополнительные виджеты QuantData, улучшения форматирования и документация. См. CONTRIBUTING.md для настройки среды разработки, рецепта добавления нового инструмента MCP и соглашений, которым нужно следовать при отправке PR.

Лицензия

MIT — см. LICENSE.