open-esg-korea

open-esg-korea es un servidor MCP (Model Context Protocol) que permite a los clientes de IA consultar información ESG de empresas cotizadas en Corea mediante lenguaje natural. Fue desarrollado por un analista de valores y utiliza la misma estructura que el proyecto hermano open-proxy-mcp (análisis de divulgaciones de DART). ■ Fuentes y método de datos Centraliza calificaciones ESG/E/S/G de 5 agencias (KCGS, MSCI, Korea ESG Institute, S&P, Sustinvest) y KPIs de gobernanza del Portal ESG de KRX; textos originales de informes de gobernanza corporativa y sostenibilidad de KIND (extracción de PDF); e información de emisiones de GEI y el sistema de comercio de emisiones del Centro de Información de GEI (GIR). Las tres fuentes no requieren API key; las calificaciones se obtienen en tiempo real sin almacenarse. Todos los valores incluyen fuente, año y condiciones de uso. ■ Instalación Se descarga el archivo .mcpb correspondiente a la plataforma (macOS Apple Silicon/Intel ~40-44MB, Windows x64 ~43MB) desde los releases y se arrastra a la pantalla de extensiones en la configuración de Claude Desktop. Incluye el runtime de Python, por lo que no requiere instalación de Python, herramientas de desarrollo ni API keys. Para ChatGPT, se guía la conexión a través de Codex (CLI, extensiones de IDE, app). El archivo incluye runtime, dependencias (mcp, httpx, pypdfium2, pdfplumber), el servidor, el manifiesto e información de build. ■ 12 Herramientas company (consulta de nombre y código de empresa), esg_ratings (calificaciones por agencia y distribución interna), sustainability_reports (lista de informes, agencias verificadoras, URLs de PDF), sustainability_report_text (búsqueda de palabras clave, extractos y vista de páginas en PDF), governance_indicators (15 KPIs clave O/X y tasa de cumplimiento), governance_policies (74 ítems de políticas), governance_report (texto original, respuestas a 28 principios detallados y motivos de incumplimiento), esg_disclosures (historial de divulgaciones), esg_screener (filtro de calificaciones para todo el mercado KOSPI, 795 empresas en 2025), ghg_emissions (emisiones por empresa, tendencia de 5 años y asignación de cuotas), ghg_industry (ranking de emisiones por sector designado y entidad), ghg_national_inventory (series temporales del inventario nacional desde 1990). ■ Precauciones de lectura Se advierte que las escalas de calificación varían por agencia (KCGS S~D, MSCI AAA~CCC, S&P 0-100, Sustinvest AA~E) y no deben compararse directamente. El símbolo '-' indica 'no evaluado', no una calificación baja. Debido a que hay pocos niveles, no se calcula el 'Top N%', sino que se cuenta dentro de la misma agencia. Los sistemas de sectores difieren entre GICS (25 grupos), el portal (21 sectores) y GIR. Para KOSDAQ, solo están disponibles las tablas de calificaciones. La gobernanza se responde en dos niveles: agregados de KRX y textos originales de la empresa; si el texto no es legible, se marca como 'no leído' en lugar de '0 cumplimientos'. Para GEI, se prioriza el alcance (límite, método Scope 2, inclusión de NF₃) antes que el valor; si no hay datos en GIR, se indica como no_data. La extracción automática de tablas es experimental (preservación del 97.4%, advertencia en celdas dudosas) y la búsqueda en PDF ignora espacios entre letras y no lee PDFs de imagen sin OCR. Los números de recepción son de KIND, distintos a los de DART. ■ Licencia El código es Apache-2.0, permitiendo uso comercial, modificación y distribución con atribución. Sin embargo, esto no aplica a los datos recuperados. Las calificaciones ESG son propiedad de sus respectivas agencias y prohíben la divulgación externa; para recolectar, almacenar, redistribuir o comercializar estas calificaciones, se debe contactar a cada agencia. Por ello, el servidor no deja rastro de las calificaciones fuera de la caché de memoria y solicita no borrar el campo de licencia en las respuestas. ■ Para desarrolladores Se puede ejecutar instalando dependencias con uv mediante python -m open_esg_korea (HTTP, localhost:8000/mcp) o --transport stdio, y registrarlo en claude_desktop_config.json. Se pueden construir extensiones por plataforma con scripts/build_mcpb.py y verificar las 12 herramientas con --check. Las pruebas funcionan sin red mediante pytest. Se proporcionan scripts de actualización de GICS y listas de empresas, scripts de probe/smoke para esquemas de KRX y acceso a KIND, así como borradores de MCP y notas de medición.