tinvest-mcp
Неофициальный локальный MCP-сервер Т-Инвестиций: анализ портфеля, подбор бумаг и план ребалансировки, заявки только после подтверждения
Установка
git clone https://github.com/plasm-one/tinvest-mcp.git
cd tinvest-mcp
uv sync
cp .env.example .env
cp config.toml.example config.toml
chmod 600 .env
uv run tinvest-mcp-doctorВпишите в .env токен песочницы TINVEST_SANDBOX_TOKEN до запуска doctor.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер работает на вашем компьютере и дает агенту 35 инструментов для брокерского счета через T-Invest API. На чтение он показывает портфель с распределением по классам, секторам и валютам, подбирает облигации, акции и фонды по фильтрам, считает доходность, волатильность, просадку и дивиденды, выдает котировки и историю операций. План ребалансировки учитывает комиссии, НКД и налог по FIFO с льготой на долгосрочное владение и может честно посоветовать ничего не делать. Заявки выключены по умолчанию: сначала черновик с проверкой лимитов из config.toml, затем сверка со свежей котировкой и отдельное подтверждение, только лимитные заявки. По умолчанию сервер работает в песочнице.
Для кого. Для частных инвесторов с брокерским счетом в Т-Банке, которые хотят разбирать портфель с агентом и держать лимиты под контролем.
Подходит, если
- Нужно понять структуру портфеля, концентрацию и отклонение от целевой доли
- Нужно подобрать облигации по сроку погашения, дюрации и ликвидности
- Нужно посчитать, окупится ли ребалансировка с учетом комиссий и налога
Не подходит, если
- Нужна официальная поддержка: у Т-Банка есть свой T-Invest MCP
- Вы хотите, чтобы агент торговал сам без подтверждений
Пример запроса к агенту
Разбери мой портфель: какая доля облигаций, где концентрация и стоит ли сейчас ребалансироватьОграничения
Проект неофициальный и в статусе бета, не является инвестиционной рекомендацией. Нужен Python 3.12+ и токен T-Invest API: для анализа достаточно токена только на чтение, токен с правом переводов автор прямо запрещает использовать. Реальная торговля требует режима prod, флага enable_real_trading и отдельного токена полного доступа. SDK t-tech-investments иногда не ставится из индекса, в README описаны обходные пути. Даже с гейтами остаются риски prompt injection и ошибок модели.
Как отключить. Выполните claude mcp remove tinvest или удалите блок tinvest из конфигурации клиента, затем отзовите токены в настройках Т-Инвестиций.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| TINVEST_SANDBOX_TOKEN секрет | Токен для песочницы, режим по умолчанию |
| TINVEST_READONLY_TOKEN секрет | Боевой токен только на чтение для анализа |
| TINVEST_FULLACCESS_TOKEN секрет | Токен полного доступа, нужен только для реальных заявок |
Проверка безопасности
- Работает с реальным брокерским счетом и может выставлять заявки на реальные деньги
- Хранит токены доступа к брокеру
- Ошибка модели или prompt injection может привести к нежелательной сделке, если торговля включена
Коротко о README
README открывается предупреждением, что программа неофициальная и работает с реальными деньгами. Описан принцип «модель анализирует, лимиты в коде», честное сравнение с официальным T-Invest MCP и список возможностей по трем группам: анализ, планирование и сделки. Установка разобрана по шагам: uv sync, выпуск токена с минимальными правами, .env и config.toml, проверка через tinvest-mcp-doctor и подключение Claude Code, Claude Desktop, Cursor и VS Code. Отдельные документы посвящены безопасности, настройке и инструментам.
Частые вопросы
Чем отличается от официального T-Invest MCP?
Официальный работает на серверах банка и ставится одной командой. Этот работает локально, хранит токен в .env, позволяет задать свои лимиты и имеет песочницу.
Может ли агент сам выставить заявку?
Только если вы включили реальную торговлю двумя настройками и добавили токен полного доступа. Даже тогда нужен черновик и отдельное подтверждение.
Похожие
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Официальный MCP-сервер и скиллы CCXT: рыночные данные, балансы и торговля по выбору на криптобиржах и рынках предсказаний
Плагины со скиллами для анализа акций, отчетностей, опционов и стартапов плюс чтение соцсетей и рыночных данных
Скиллы и MCP-сервер для опционных трейдеров: котировки, технический анализ, греки, спреды, сканеры и портфель Interactive Brokers