Ibkr — MCP-сервер для работы с Interactive Brokers API
Ibkr — это Python-приложение на базе FastAPI, которое предоставляет MCP-сервер для взаимодействия с API брокера Interactive Brokers (IBKR). Сервер позволяет получать данные о портфеле, автоматизировать мониторинг и интегрироваться с торговыми дашбордами.
Возможности
- Модульная структура проекта
- Документация API через Swagger UI
- Асинхронная обработка запросов
- Конфигурация через переменные окружения для безопасного хранения учётных данных
- Простота развёртывания и разработки
Установка
-
Клонируйте репозиторий:
git clone https://github.com/yourusername/ibkr.git
cd ibkr
-
Создайте и активируйте виртуальное окружение:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
-
Установите зависимости:
pip install -r requirements.txt
Конфигурация
Создайте файл .env в корне проекта и укажите переменные окружения:
IBKR_ACCOUNT_ID=ваш_идентификатор
IBKR_API_KEY=ваш_ключ
Запуск
Запустите сервер:
uvicorn main:app --reload
После запуска документация API будет доступна по адресу http://localhost:8000/docs.
Использование
После запуска сервера вы можете отправлять запросы к эндпоинтам API для получения данных портфеля. Пример запроса через curl:
curl http://localhost:8000/portfolio
Примеры использования
- Автоматический мониторинг портфеля — настройте периодические запросы к API для отслеживания изменений.
- Интеграция с торговыми дашбордами — используйте данные из Ibkr для визуализации в Grafana или других инструментах.
- Анализ инвестиционных стратегий — собирайте исторические данные для бэктестинга.
Предупреждения
- Убедитесь, что ваш аккаунт IBKR настроен для работы с API и имеет необходимые разрешения.
- Храните учётные данные в
.env и не добавляйте этот файл в систему контроля версий.
- Сервер предназначен для локального использования; при публичном доступе обязательно используйте HTTPS и аутентификацию.
Зависимости
- Python 3.8+
- FastAPI
- Uvicorn
- python-dotenv
- ib_insync (для работы с IBKR API)
Лицензия
Проект распространяется под лицензией MIT. Подробнее — в файле LICENSE.
Ссылки
Комментарии
Комментариев пока нет. Будьте первым.