Об этом проекте

open-esg-korea — это MCP (Model Context Protocol) сервер, который позволяет AI-клиентам запрашивать информацию об ESG корейских публичных компаний на естественном языке. Проект разработан аналитиком ценных бумаг и имеет структуру, аналогичную open-proxy-mcp (анализ раскрытий DART). ■ Источники и методы данных Сервер объединяет данные из трех источников: ESG-рейтинги 5 агентств (KCGS, MSCI, Korea ESG Institute, S&P, Sustinvest) и ключевые показатели корпоративного управления из KRX ESG Portal; оригиналы отчетов об устойчивом развитии и корпоративном управлении (извлечение текста из PDF) из KIND; данные о выбросах парниковых газов и системе торговли квотами из GIR (Центр общей информации о парниковых газах). API-ключи не требуются; рейтинги не хранятся, а запрашиваются в реальном времени. Каждое значение сопровождается источником, годом и условиями использования. ■ Установка Пользователи могут скачать файл .mcpb для своей платформы (macOS Apple Silicon/Intel ~40-44МБ, Windows x64 ~43МБ) и перетащить его в раздел расширений настроек Claude Desktop. Python-рантайм включен в сборку, поэтому установка Python или инструментов разработки не требуется. Для ChatGPT предусмотрено подключение через Codex (CLI, IDE, приложение). В состав установочного файла входят рантайм, зависимости (mcp, httpx, pypdfium2, pdfplumber), основной сервер, манифест и информация о сборке. ■ 12 инструментов company (поиск компании/кода акции), esg_ratings (рейтинги по агентствам и их распределение), sustainability_reports (список отчетов, органы верификации, ссылки на PDF), sustainability_report_text (поиск по ключевым словам, выдержки, просмотр страниц PDF), governance_indicators (15 ключевых показателей O/X, уровень соблюдения), governance_policies (74 пункта политики), governance_report (оригиналы отчетов, ответы на 28 принципов, причины несоблюдения), esg_disclosures (история раскрытия информации), esg_screener (скринер рейтингов для всего рынка, 795 компаний на 2025 г.), ghg_emissions (выбросы по компаниям, тренд за 5 лет, сравнение с квотами), ghg_industry (рейтинг выбросов по отраслям и юрлицам), ghg_national_inventory (временные ряды национального инвентаря с 1990 г.). ■ Важные примечания при чтении Пользователей предупреждают, что шкалы рейтингов различаются (KCGS S~D, MSCI AAA~CCC, S&P 0-100, Sustinvest AA~E), поэтому прямое сравнение недопустимо. Символ «-» означает отсутствие оценки, а не плохой результат. Из-за ограниченного количества ступеней рейтинга расчет «верхних N%» не производится; ответы даются на основе подсчета внутри одного агентства. Системы отраслей (GICS, портал, GIR) также различаются. Для компаний KOSDAQ доступны только таблицы рейтингов. Данные по управлению предоставляются на двух уровнях: агрегированные данные KRX и оригинальные тексты компаний; если текст недоступен, выводится «не удалось прочитать», а не «0 соблюдено». Для парниковых газов сначала указывается область охвата (границы, метод Scope 2, включение NF₃). Автоматическое извлечение таблиц из отчетов является экспериментальным (сохранность данных 97.4%), а поиск по PDF игнорирует пробелы между буквами и не поддерживает OCR для изображений. Номера заявок соответствуют KIND и отличаются от DART. ■ Лицензионные ограничения Код распространяется под лицензией Apache-2.0, что позволяет свободно использовать, изменять и распространять его при условии указания авторства. Однако эта лицензия не распространяется на данные, которые считывает сервер. ESG-рейтинги являются интеллектуальной собственностью агентств, которые запрещают их внешнее раскрытие. Сбор, хранение, перепродажа или создание продуктов на основе этих рейтингов требуют согласования с агентствами. Поэтому сервер не сохраняет рейтинги вне кэша памяти, и пользователей просят не удалять поле license из ответов. ■ Для разработчиков После установки зависимостей через uv сервер можно запустить командой python -m open_esg_korea (HTTP, localhost:8000/mcp) или с параметром --transport stdio, а затем зарегистрировать в claude_desktop_config.json. Скрипт scripts/build_mcpb.py позволяет самостоятельно собирать расширения, а флаг --check проверяет работоспособность 12 инструментов. Тесты запускаются через pytest без сети. Также предоставляются скрипты обновления GICS и списков компаний, probe/smoke скрипты для проверки схем KRX и KIND, а также документация по черновикам MCP и заметки по измерениям.