open-esg-korea

open-esg-korea est un serveur MCP (Model Context Protocol) qui permet d'interroger en langage naturel les informations ESG des sociétés cotées coréennes via des clients IA. Créé par un analyste financier, il partage la même structure que le projet frère open-proxy-mcp (analyse des divulgations DART). ■ Sources et méthodes de données Le serveur centralise les notes ESG/E/S/G de 5 agences (KCGS, MSCI, Korea ESG Research Institute, S&P, Sustinvest) du portail ESG de la KRX, les rapports de gouvernance et de durabilité de KIND (extraction de texte PDF), ainsi que les déclarations de gaz à effet de serre (GES) et les informations sur le système d'échange de quotas d'émission du GIR. Aucune clé API n'est requise ; les notes sont récupérées en temps réel sans être stockées. Chaque valeur est accompagnée de sa source, de l'année et des conditions d'utilisation. ■ Installation Il suffit de télécharger le fichier .mcpb correspondant à la plateforme (macOS Apple Silicon/Intel ~40-44 Mo, Windows x64 ~43 Mo) et de le glisser-déposer dans la section extensions des paramètres de Claude Desktop. Le runtime Python est inclus, éliminant le besoin de Python, d'outils de développement ou de clés API. Pour ChatGPT, le chemin de connexion via Codex (CLI, extension IDE, app) est indiqué. Le package contient le runtime, les dépendances (mcp, httpx, pypdfium2, pdfplumber), le serveur, le manifeste et les informations de build. ■ Les 12 outils company (recherche nom/code), esg_ratings (notes par agence et distribution), sustainability_reports (liste, organisme de vérification, URL PDF), sustainability_report_text (recherche par mots-clés, extraits, pagination), governance_indicators (15 indicateurs clés O/X, taux de conformité), governance_policies (74 articles de politique), governance_report (texte original, réponses aux 28 principes, motifs de non-conformité), esg_disclosures (historique des publications), esg_screener (filtre global, 795 sociétés en 2025), ghg_emissions (émissions par société, tendance sur 5 ans, quotas), ghg_industry (classement par secteur et entité), ghg_national_inventory (séries chronologiques nationales depuis 1990). ■ Précautions de lecture L'utilisateur est averti que les échelles de notation diffèrent selon les agences (KCGS S~D, MSCI AAA~CCC, S&P 0-100, Sustinvest AA~E) et ne doivent pas être comparées directement. Le symbole '-' signifie non évalué. En raison du faible nombre de paliers, le serveur compte les occurrences au sein d'une même agence plutôt que de fournir un 'top N%'. Les systèmes de classification sectorielle varient entre GICS (25), le portail (21) et le GIR. Pour le KOSDAQ, seules les tables de notes sont disponibles. La gouvernance est traitée sur deux niveaux : agrégation KRX et texte original ; si le texte est illisible, il est marqué comme 'non lu' et non '0 conformité'. Pour les GES, le périmètre (Scope 2, NF₃) est priorisé sur la valeur. L'extraction automatique de tableaux est expérimentale (précision 97,4%) et les PDF images ne sont pas lus sans OCR. Les numéros de réception sont ceux de KIND, différents de DART. ■ Licence Le code est sous licence Apache-2.0 (utilisation commerciale, modification et distribution libres avec mention de la source). Cependant, cela ne s'applique pas aux données récupérées. Les notes ESG sont la propriété des agences qui interdisent leur diffusion publique. Il est interdit de collecter, stocker, redistribuer ou revendre ces notes. Le serveur ne conserve les données qu'en cache mémoire et demande de ne pas supprimer le champ 'license' des réponses. ■ Pour les développeurs Après installation des dépendances avec uv, exécutez via python -m open_esg_korea (HTTP, localhost:8000/mcp) ou --transport stdio, puis enregistrez-le dans claude_desktop_config.json. Le script scripts/build_mcpb.py permet de builder les extensions par plateforme, et --check vérifie la réponse des 12 outils. Les tests sont exécutables via pytest sans réseau. Sont également fournis : scripts de mise à jour GICS/sociétés, scripts de test probe/smoke pour KRX/KIND, et notes de conception MCP.