MCP-сервер Interactive Brokers

ОТКАЗ ОТ ОТВЕТСТВЕННОСТИ: Это неофициальный MCP-сервер, разработанный сообществом, и он НЕ связан с Interactive Brokers и не поддерживается ими. Это программное обеспечение находится в альфа-версии и может работать с ошибками.

Сервер протокола контекста модели (MCP), обеспечивающий интеграцию с торговой платформой Interactive Brokers. Этот сервер позволяет ИИ-ассистентам взаимодействовать с вашим счетом IB для получения рыночных данных, проверки позиций и размещения торговых ордеров.

🔒 Уведомление о безопасности

Related MCP server: Interactive Brokers MCP Server

Функции

• Интеграция с API Interactive Brokers: Полные торговые возможности, включая управление счетом, отслеживание позиций, рыночные данные в реальном времени и управление ордерами (рыночные, лимитные и стоп-ордера)

• Поддержка Flex Query: Выполнение Flex-запросов для получения выписок по счету, подтверждений сделок и исторических данных. Запросы автоматически сохраняются для удобного повторного использования

• Гибкая аутентификация: Выбор между OAuth-аутентификацией через браузер или безголовым (headless) режимом с использованием учетных данных для автоматизированных сред

• Простая настройка: Запуск напрямую через npx — не требуется Docker или дополнительные установки. Включает предварительно настроенный IB Gateway и среду выполнения Java для всех платформ

Уведомление о безопасности

ВАЖНЫЕ ПРЕДУПРЕЖДЕНИЯ:

• Финансовый риск: Торговля сопряжена с существенным риском убытков. Всегда сначала тестируйте на демо-счете (paper trading).

• Безопасность: Это программное обеспечение обрабатывает конфиденциальные финансовые данные. Запускайте его только локально, никогда не используйте на публичных серверах.

• Без гарантий: Это неофициальное программное обеспечение предоставляется без каких-либо гарантий. Используйте на свой страх и риск.

• Не является финансовой консультацией: Этот инструмент предназначен только для автоматизации, а не для финансовых советов.

Предварительные требования

Дополнительная установка не требуется! Этот пакет включает:

• Предварительно настроенный IB Gateway для всех платформ (Linux, macOS, Windows)

• Среду выполнения Java (JRE) для IB Gateway, включая сборку musl-libc для контейнеров на базе Alpine (например, node:lts-alpine, supergateway)

• Все необходимые зависимости

Вам понадобятся только:

• Счет в Interactive Brokers (демо или реальный)

• Node.js 18+ (для запуска MCP-сервера)

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

Добавьте этот MCP-сервер в конфигурацию Cursor/Claude:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"]
    }
  }
}

При первом использовании сервера автоматически откроется окно веб-браузера для процесса OAuth-аутентификации Interactive Brokers. Войдите в систему, используя свои учетные данные IB, чтобы авторизовать подключение.

Настройка безголового (headless) режима

Для автоматизированных сред или если вы предпочитаете не использовать браузер для аутентификации, вы можете включить безголовый режим, настроив его в конфигурации MCP-сервера:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password"
      }
    }
  }
}

В безголовом режиме сервер будет автоматически проходить аутентификацию с использованием ваших учетных данных без открытия окна браузера. Это полезно для:

• Автоматизированных торговых систем

• Серверных сред без графического интерфейса

• CI/CD конвейеров

• Ситуаций, когда взаимодействие с браузером нежелательно

Важно: Даже в безголовом режиме Interactive Brokers может потребовать двухфакторную аутентификацию (2FA). Когда срабатывает 2FA, безголовая аутентификация будет ждать, пока вы завершите процесс 2FA через настроенный вами метод (мобильное приложение, SMS и т. д.), прежде чем продолжить.

Чтобы включить демо-торговлю (paper trading), добавьте "IB_PAPER_TRADING": "true" в переменные окружения:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_HEADLESS_MODE": "true",
        "IB_USERNAME": "your_ib_username",
        "IB_PASSWORD_AUTH": "your_ib_password",
        "IB_PAPER_TRADING": "true"
      }
    }
  }
}

Примечание по безопасности: Храните учетные данные в безопасности и никогда не добавляйте их в систему контроля версий. Рассмотрите возможность использования файлов переменных окружения или систем безопасного управления учетными данными.

Настройка Flex Query (опционально)

Чтобы использовать Flex-запросы для получения выписок по счету и исторических данных, вам необходимо настроить токен Flex Web Service:

{
  "mcpServers": {
    "interactive-brokers": {
      "command": "npx",
      "args": ["-y", "interactive-brokers-mcp"],
      "env": {
        "IB_FLEX_TOKEN": "your_flex_token_here"
      }
    }
  }
}

Как получить токен Flex:

1. Войдите в Управление счетом Interactive Brokers

2. Перейдите в Settings (Настройки) → Account Settings (Настройки счета)

3. Перейдите в Reporting (Отчетность) → Flex Web Service

4. Создайте или получите свой токен Flex Web Service

Подробные инструкции по включению Flex Web Service см. в руководстве IB Flex Web Service.

Создание Flex-запросов:

1. Перейдите в Reports (Отчеты) → Flex Queries (Flex-запросы) в управлении счетом

2. Создайте или настройте шаблон запроса

3. Нажмите на значок информации рядом с вашим запросом, чтобы найти его Query ID

Полное руководство по созданию и настройке Flex-запросов см. в руководстве IB Flex Queries.

Примечание: При первом выполнении Flex-запроса MCP-сервер автоматически сохраняет его под именем из API. В будущем к запросу можно обращаться как по его ID, так и по сохраненному имени.

Функции Flex Query:

• Автоматическая память: При выполнении Flex-запроса он автоматически сохраняется для будущего использования

• Удобное повторное использование: Ранее использованные запросы запоминаются — не нужно постоянно копировать ID запросов

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

• Удаление запросов: Удаляйте ненужные запросы с помощью инструмента forget_flex_query

Переменные конфигурации

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

Торговля и управление счетом

Flex-запросы (требуется IB_FLEX_TOKEN)

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

Проблемы с аутентификацией:

• Используйте веб-интерфейс, который открывается автоматически

• Завершите любую требуемую двухфакторную аутентификацию

• Попробуйте режим демо-торговли, если реальная торговля не работает

Поддержка

• Этот сервер: Откройте issue в этом репозитории.

Лицензия

Лицензия MIT — подробности см. в файле LICENSE.

Спасибо нашим участникам

Огромное спасибо всем, кто внес свой вклад в улучшение этого проекта.