عن المشروع

يعد open-esg-korea خادم MCP (Model Context Protocol) يتيح للعملاء المعتمدين على الذكاء الاصطناعي الاستفسار عن معلومات ESG للشركات الكورية المدرجة باستخدام اللغة الطبيعية. تم تطويره بواسطة محلل أوراق مالية، ويتبع نفس هيكلية المشروع الشقيق open-proxy-mcp (المخصص لتحليل إفصاحات DART). ■ مصادر البيانات وطريقتها يتعامل الخادم في مكان واحد مع تصنيفات ESG/E/S/G من 5 مؤسسات (KCGS، MSCI، المعهد الكوري لـ ESG، S&P، Sustinvest) ومؤشرات الحوكمة المؤسسية الأساسية من بوابة KRX ESG، والنصوص الأصلية لتقارير الحوكمة المؤسسية وتقارير الاستدامة من إفصاحات KIND (استخراج نصوص PDF)، ومعلومات بيانات الغازات الدفيئة ونظام تداول الانبعاثات من مركز معلومات الغازات الدفيئة GIR. لا تتطلب هذه المصادر الثلاثة مفاتيح API للاستعلام، ولا يتم تخزين التصنيفات بل يتم جلبها في الوقت الفعلي عند كل سؤال، مع إرفاق المصدر والسنة وشروط الاستخدام لكل قيمة. ■ التثبيت يمكن تحميل ملف .mcpb المناسب للمنصة من الإصدارات (حوالي 40-44 ميجابايت لـ macOS و43 ميجابايت لـ Windows x64) وسحبه وإفلاته في شاشة الإضافات في إعدادات Claude Desktop. يتضمن الحزمة بيئة تشغيل Python، لذا لا يلزم وجود Python أو أدوات تطوير أو مفاتيح API. لا تتوفر حزمة لـ Linux حالياً، وبالنسبة لـ ChatGPT، يتم توجيه المستخدمين لربط خادم MCP عبر Codex. تحتوي ملفات التثبيت على بيئة التشغيل، والتبعيات (mcp، httpx، pypdfium2، pdfplumber)، وجسم الخادم، والبيان (manifest)، ومعلومات البناء. ■ الأدوات الـ 12 تشمل الأدوات: company (البحث عن اسم الشركة ورمز السهم)، esg_ratings (التصنيفات حسب المؤسسة وتوزيعها)، sustainability_reports (قائمة التقارير وجهات التحقق وروابط PDF)، sustainability_report_text (البحث بالكلمات المفتاحية في PDF والاقتباس)، governance_indicators (15 مؤشراً أساسياً بنعم/لا ومعدل الامتثال)، 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). ترمز العلامة '-' إلى عدم التقييم وليس درجة سيئة. نظراً لأن التصنيفات تتكون من 6-7 مستويات فقط، يتم الإجابة بالعدد داخل المؤسسة الواحدة بدلاً من 'أعلى N%'. تختلف أنظمة القطاعات بين GICS (25 مجموعة)، وبوابة KRX (21 قطاعاً)، وقطاعات GIR. تظهر نتائج KOSDAQ في جداول التصنيفات فقط. يتم الإجابة على الحوكمة عبر مستويين: تجميعات KRX والنصوص الأصلية للشركة، ويتم التمييز بين '0 امتثال' و'تعذر القراءة'. بالنسبة للغازات الدفيئة، يتم تقديم النطاق (الحدود، طريقة Scope 2، تضمين NF₃) قبل القيمة، وتظهر no_data إذا لم تتوفر في GIR. استخراج الجداول تلقائياً من التقارير تجريبي (دقة حفظ القيم 97.4%)، والبحث في PDF يتجاهل المسافات بين الحروف ولا يقرأ ملفات PDF الصورية بدون OCR. أرقام الاستلام هي أرقام KIND وتختلف عن عارض DART. ■ ملاحظات الترخيص الكود مرخص بموجب Apache-2.0، مما يسمح بالاستخدام التجاري والتعديل والتوزيع بشرط ذكر المصدر. ومع ذلك، لا ينطبق هذا الترخيص على البيانات التي يقرأها الخادم. تصنيفات ESG هي ملكية فكرية لمؤسسات التقييم التي تحظر النشر الخارجي، لذا يجب استشارة المؤسسات قبل جمع أو تخزين أو إعادة توزيع أو بيع التصنيفات أو تحويلها لمنتجات. لهذا السبب، لا يحتفظ الخادم بالتصنيفات خارج ذاكرة التخزين المؤقت (cache) ويطلب عدم حذف حقل الترخيص في الاستجابات. ■ للمطورين يمكن التشغيل بعد تثبيت التبعيات عبر uv باستخدام python -m open_esg_korea (HTTP, localhost:8000/mcp) أو --transport stdio، وتسجيله في claude_desktop_config.json للربط المحلي. يمكن بناء الإضافات لكل منصة عبر scripts/build_mcpb.py والتحقق من استجابة الأدوات الـ 12 باستخدام --check. تعمل الاختبارات عبر pytest بدون شبكة. يتم توفير سكربتات لتحديث تصنيفات GICS وقوائم الشركات، وسكربتات probe/smoke لفحص استجابات KRX والوصول إلى KIND، بالإضافة إلى مسودات MCP وملاحظات القياس.