KIS Open Trading API — MCP для брокера Korea Investment
KIS Open Trading API
Официальный MCP-сервер корейского брокера Korea Investment: торговый API и поиск по его документации для ИИ-клиента
- 1 658 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Ключи приложения и номера брокерских счетов лежат в переменных окружения клиента
- Агент видит баланс и историю счета, а при полном наборе может отправлять, менять и отменять заказы с реальными деньгами
- Сервер скачивает код методов с GitHub и исполняет его во временной среде во время работы
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kis-open-trading-apiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Ключи приложения и номера брокерских счетов лежат в переменных окружения клиента
- Агент видит баланс и историю счета, а при полном наборе может отправлять, менять и отменять заказы с реальными деньгами
- Сервер скачивает код методов с GitHub и исполняет его во временной среде во время работы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий корейского брокера Korea Investment содержит образцы кода для KIS Open API и два MCP-сервера. KIS Trading MCP подключает ИИ-клиента к торговому API: котировки и стакан, баланс и история счета, заказы с изменением и отменой. Охвачены корейский и зарубежные рынки, от акций до деривативов. KIS Code Assistant MCP решает другую задачу: ищет в документации API и примерах кода нужный метод по запросу на естественном языке, чтобы агент написал свою интеграцию. Trading MCP запускается командой `npx -y @koreainvestment/kis-trading-mcp` по stdio, также есть запуск в Docker с SSE и установка из исходников. Ключи приложения и номера счетов задаются переменными окружения. Остальные каталоги репозитория дополняют MCP: examples_llm с примерами по отдельным методам, strategy_builder и backtester на движке Lean.
Для кого. Для разработчиков и частных инвесторов с брокерским счетом в Korea Investment, которые хотят подключить котировки и сделки к Claude Desktop или Cursor.
Подходит, если
- Нужно спросить у ассистента текущую цену, стакан и график по корейской или зарубежной бумаге через API брокера
- Хотите разобрать баланс, историю сделок и прибыль по счету, не открывая приложение брокера
- Пишете торгового бота на Python и ищете нужный метод KIS Open API: подключите Code Assistant MCP с поиском по примерам
- Хотите сначала проверить сценарий на учебном счете: сервер различает реальную и учебную среды
Не подходит, если
- У вас нет счета в Korea Investment и ключей KIS Developers: без них вызовы не работают
- Нужна уверенность, что агент не отправит заказ: полный набор инструментов включает торговые заказы
- Нужен российский брокер: сервер подключается только к корейскому
- Требуется финансовая консультация: сервер дает данные и операции без рекомендаций
Пример запроса к агенту
Через kis-trading покажи текущую цену и стакан Samsung Electronics, а затем остаток на моем учебном счете. Заказов не отправляйMCP
- Транспорт
- stdio, sse
- Авторизация
- API-ключ
Переменные окружения
KIS_APP_KEYобязательная, секрет- Ключ приложения для реальной торговли из KIS Developers
KIS_APP_SECRETобязательная, секрет- Секрет приложения для реальной торговли
KIS_PAPER_APP_KEYсекрет- Ключ приложения учебной среды
KIS_PAPER_APP_SECRETсекрет- Секрет приложения учебной среды
KIS_ACCT_STOCKсекрет- Номер реального счета для акций
KIS_PAPER_STOCKсекрет- Номер учебного счета для акций
Ограничения
- Для вызовов нужны Node.js 18 или новее, Python 3.11 или новее, uv и ключи приложения из центра разработчиков KIS Developers. Для Docker понадобится Docker 20.10 или новее.
- Документация MCP написана по-корейски. Образцы кода справочные и могут меняться без уведомления, ответственность за запуск лежит на пользователе.
- Сервер подгружает код методов из GitHub во время работы и выполняет его во временной среде.
- Лицензия репозитория не определена на уровне корня, у каталога MCP есть собственный файл LICENSE.
- Счет в этом брокере доступен не каждому, проверьте условия открытия до установки.
Как отключить. Уберите запись kis-trading из настроек MCP-клиента и перезапустите клиент. Ключи приложения в центре KIS Developers можно отозвать там же, а переменные окружения удалите из конфигурации клиента.
Частые вопросы
Как подключить KIS Trading MCP к Claude Desktop?
В файл claude_desktop_config.json добавьте сервер kis-trading с командой npx и аргументами -y @koreainvestment/kis-trading-mcp, а в блок env внесите ключи KIS_APP_KEY и KIS_APP_SECRET. После перезапуска Claude Desktop сервер появится в списке инструментов. Для Cursor та же запись добавляется в раздел MCP Servers настроек.
Чем отличаются KIS Trading MCP и KIS Code Assistant MCP?
Trading MCP вызывает торговый API: котировки, баланс, заказы. Code Assistant MCP ничего не торгует, он ищет в документации и образцах нужный метод и показывает пример кода для вашей программы.
Можно ли сначала попробовать на учебном счете?
Да. Для учебной среды задают отдельные ключи KIS_PAPER_APP_KEY и KIS_PAPER_APP_SECRET и номера счетов KIS_PAPER_STOCK и KIS_PAPER_FUTURE.
Какие рынки и инструменты доступны через KIS MCP?
Внутренние и зарубежные акции, внутренние и зарубежные фьючерсы и опционы, внутренние облигации, ETF и ETN, ELW. Кроме котировок и заказов, сервер отдает рейтинги и данные по торговым потокам.
Как запустить сервер в Docker?
Клонируйте репозиторий, соберите образ по Dockerfile из каталога Kis Trading MCP и задайте ключи через переменные окружения. В контейнере сервер работает по SSE.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для T-Invest API на Kotlin: рыночные данные, заявки и стоп-заявки, песочница с виртуальными деньгами
MCP для автоторговли на Т-Инвестициях
Tinkoff Trader MCP
MCP-сервер для Т-Инвестиций с анализом рынка, бэктестом пяти стратегий, риск-менеджментом и выставлением заявок, торговля выключена по умолчанию
MCP для Т-Инвестиций, только чтение
T-Bank Invest MCP Server (read-only)
MCP-сервер для портфеля Т-Инвестиций без прав на сделки: позиции, операции, рыночные данные, техническая и фундаментальная аналитика
MCP для данных Мосбиржи и Т-Инвестиций
market-mcp
MCP-сервер рыночных данных Московской биржи (ISS) и Т-Инвестиций, только чтение: котировки, свечи, скринер, портфель по желанию
MCP для Т-Инвестиций на C#
TInvestMcp
Консольный MCP-сервер на C# для Т-Инвестиций: счета, портфель, дивиденды, операции и брокерские отчеты, только чтение
Неофициальный локальный MCP-сервер Т-Инвестиций: анализ портфеля, подбор бумаг и план ребалансировки, заявки только после подтверждения
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| KIS Open Trading API — MCP для брокера Korea Investment (эта запись) | да | API-ключ | 1 658 | |
| Financial Datasets MCP | да | API-ключ | 2 315 | данные по компаниям, ценам акций и новостям из Financial Datasets API, без счета и заказов |
| MCP-сервер для Dzengi | нет | ключ необязателен | 0 | площадка Dzengi: рыночные данные только для чтения, торговля за дополнительными проверками |
| TradingView MCP Bridge | нет | не нужна | 6 995 | связывает агента с TradingView Desktop для анализа графиков и Pine Script, брокерского счета нет |
Коротко о README
Кроме MCP, KIS Developers анонсирует два новых сервиса: ИИ-агента по OpenAPI и площадку для инвестиционных стратегий. Описание MCP показывает сценарии для частных инвесторов, квантов и финтех-команд.