korea-stock-mcp

korea-stock-mcp

jjlabsioISC
140 звёзд31 форков
MCP-сервер для доступа к данным корейского фондового рынка через официальные API DART и KRX. Даёт AI-ассистентам доступ к корпоративным раскрытиям, котировкам KOSPI/KOSDAQ/KONEX и финансовой отчётности в формате XBRL. Подойдёт разработчикам, которые создают агентов для анализа корейских компаний или автоматизируют сбор биржевых данных. Работает без ручного копирования информации из браузера.
Открыть на GitHub

Установка

npx -y korea-stock-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикjjlabsio
  • ЛицензияISC

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Поиск корпоративных раскрытий DART с фильтром по типу отчёта и дате.
  • Извлечение структурированных данных из оригинальных XML-файлов раскрытий.
  • Детальный анализ финансовой отчётности в формате XBRL: баланс, отчёт о прибылях и убытках.
  • Загрузка ежедневных данных по акциям: цена открытия, закрытия, объём торгов для рынков KOSPI, KOSDAQ, KONEX.
  • Получение базовой информации об инструментах: название, тикер, сектор.
  • Умная обработка больших отчётов (от 1 МБ): сначала показывает оглавление, затем подгружает нужные разделы по запросу. Это экономит токены.
  • Поиск регистрационного кода компании (corp_code) по названию или тикеру.
  • Пошаговый сбор данных: можно разбить сложный аналитический запрос на несколько простых шагов.

Как подключить

1. Получите API-ключи

Потребуются два ключа: от DART и от KRX.

DART: зарегистрируйтесь на портале opendart.fss.or.kr и запросите ключ в разделе управления API.

KRX: зарегистрируйтесь на openapi.krx.co.kr и подайте заявку на доступ к шести пунктам: ежедневные торги и базовые данные для KOSPI, KOSDAQ, KONEX. Одобрение занимает до одного дня.

2. Настройте конфигурацию

Убедитесь, что установлен Node.js. Добавьте сервер в настройки MCP-клиента. Пример для Claude Desktop:

{ "mcpServers": { "korea-stock-mcp": { "command": "npx", "args": ["-y", "korea-stock-mcp@latest"], "env": { "DART_API_KEY": "ВАШ_КЛЮЧ_DART", "KRX_API_KEY": "ВАШ_КЛЮЧ_KRX" } } } }

3. Перезапустите клиент

Закройте и откройте приложение заново. Сервер готов к работе.

Примеры запросов

  • «Найди последние квартальные раскрытия Samsung Electronics и сравни их выручку с предыдущим кварталом».
  • «Покажи динамику цены акций Hyundai Motor за последнюю неделю на KOSPI».
  • «Извлеки финансовую отчётность LG Electronics за 2023 год из отчёта XBRL и покажи показатель EBITDA».
  • «Найди код компании Kakao и выведи её базовую биржевую информацию».

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: ISC
  • Установка: npx -y korea-stock-mcp@latest
  • Требования: Node.js, DART API Key, KRX API Key
  • Совместимость: Claude Desktop, любой MCP-клиент со stdio

Поделиться