इस प्रोजेक्ट के बारे में

open-esg-korea एक MCP (Model Context Protocol) सर्वर है जो AI क्लाइंट्स को प्राकृतिक भाषा के माध्यम से कोरियाई सूचीबद्ध कंपनियों की ESG जानकारी पूछने की अनुमति देता है। इसे एक स्टॉक ब्रोकरेज विश्लेषक द्वारा बनाया गया है और यह open-proxy-mcp (DART प्रकटीकरण विश्लेषण) के समान संरचना का उपयोग करता है। ■ डेटा स्रोत और विधि यह KRX ESG पोर्टल की 5 एजेंसियों (KCGS, MSCI, Korea ESG Institute, S&P, Sustinvest) की ESG/E/S/G रेटिंग और कॉर्पोरेट गवर्नेंस संकेतकों, KIND प्रकटीकरण की कॉर्पोरेट गवर्नेंस रिपोर्ट और स्थिरता रिपोर्ट (PDF टेक्स्ट एक्सट्रैक्शन), और GIR ग्रीनहाउस गैस इन्वेंटरी सेंटर के उत्सर्जन विवरण और उत्सर्जन ट्रेडिंग सिस्टम की जानकारी को एक स्थान पर लाता है। इन तीनों के लिए API कुंजी की आवश्यकता नहीं है, और रेटिंग को स्टोर करने के बजाय प्रश्न के समय वास्तविक समय में प्राप्त किया जाता है। सभी मानों के साथ स्रोत, वर्ष और उपयोग की शर्तें जुड़ी होती हैं। ■ इंस्टॉलेशन रिलीज़ से अपने प्लेटफ़ॉर्म के लिए उपयुक्त .mcpb फ़ाइल (macOS Apple Silicon/Intel ~40-44MB, Windows x64 ~43MB) डाउनलोड करें और इसे Claude Desktop की सेटिंग्स → एक्सटेंशन स्क्रीन पर ड्रैग और ड्रॉप करें। इसमें पायथन रनटाइम बंडल है, इसलिए पायथन, डेवलपमेंट टूल या API कुंजी की आवश्यकता नहीं है। लिनक्स बंडल अभी उपलब्ध नहीं है, और ChatGPT के लिए Codex (CLI/IDE एक्सटेंशन/ऐप) के माध्यम से MCP सर्वर कनेक्शन का मार्ग निर्देशित किया गया है। इंस्टॉलेशन फ़ाइल में रनटाइम, डिपेंडेंसी (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 (KOSPI रेटिंग स्क्रीनर, 2025 में 795 कंपनियां), ghg_emissions (कंपनी उत्सर्जन, 5 साल का रुझान, कोटा तुलना), ghg_industry (निर्दिष्ट उद्योग/कॉर्पोरेट उत्सर्जन रैंकिंग), ghg_national_inventory (1990 से राष्ट्रीय इन्वेंटरी टाइम सीरीज़)। ■ पढ़ने के लिए सावधानियां उपयोगकर्ताओं को सूचित किया जाता है कि विभिन्न एजेंसियों के रेटिंग स्केल अलग-अलग होते हैं (KCGS S~D, MSCI AAA~CCC, S&P 0-100, Sustinvest AA~E), इसलिए उनकी सीधी तुलना न करें। '-' का अर्थ 'गैर-मूल्यांकित' है, न कि 0 अंक या खराब रेटिंग। रेटिंग स्तर कम होने के कारण समान स्कोर अधिक होते हैं, इसलिए 'शीर्ष N%' के बजाय एजेंसी के भीतर गणना की जाती है। उद्योग वर्गीकरण GICS (25 समूह), पोर्टल (21 उद्योग), और GIR निर्दिष्ट उद्योगों के बीच भिन्न हैं। KOSDAQ के लिए केवल रेटिंग तालिका उपलब्ध है। गवर्नेंस के लिए KRX डेटा और कंपनी के मूल पाठ के दो स्तर दिए जाते हैं; यदि मूल पाठ नहीं पढ़ा जा सकता, तो इसे '0 अनुपालन' के बजाय 'पढ़ने में असमर्थ' के रूप में वर्गीकृत किया जाता है। ग्रीनहाउस गैसों के लिए, मान से पहले सीमा (Scope 2 विधि, NF₃ समावेश) प्रस्तुत की जाती है, और GIR में अनुपलब्ध होने पर 'no_data' दिखाया जाता है। रिपोर्ट से स्वचालित तालिका निष्कर्षण प्रयोगात्मक है (97.4% मान संरक्षण), और PDF खोज स्पेस को अनदेखा करती है; इमेज-आधारित 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 वर्गीकरण/सूचीबद्ध कंपनी स्नैपशॉट अपडेट स्क्रिप्ट, KRX रिस्पॉन्स स्कीमा और KIND प्रकटीकरण जांच के लिए probe/smoke स्क्रिप्ट, और MCP ड्राफ्ट/मापन नोट्स भी प्रदान किए गए हैं।