منصوبے کے بارے میں

open-esg-korea ایک MCP (Model Context Protocol) سرور ہے جو AI کلائنٹس کو کوریائی فہرست شدہ کمپنیوں کی ESG معلومات قدرتی زبان میں پوچھنے کی اجازت دیتا ہے۔ اسے ایک سیکیورٹیز اینالسٹ نے تیار کیا ہے اور یہ open-proxy-mcp (DART ڈسکلوژر تجزیہ) کے ڈھانچے پر مبنی ہے۔ ■ ڈیٹا کے ذرائع اور طریقہ کار یہ سرور KRX ESG پورٹل کے 5 اداروں (KCGS, MSCI, Korea ESG Research Institute, S&P, Sustinvest) کے ESG/E/S/G گریڈز، KIND ڈسکلوژرز سے کارپوریٹ گورننس رپورٹس اور پائیداری رپورٹس (PDF سے متن نکال کر)، اور GIR گرین ہاؤس گیس جامع معلومات مرکز سے اخراجات کے بیانات اور ایمیشن ٹریڈنگ سسٹم کی معلومات فراہم کرتا ہے۔ ان تینوں ذرائع کے لیے API کیز کی ضرورت نہیں ہے، اور گریڈز کو محفوظ کرنے کے بجائے ہر سوال پر ریئل ٹائم میں حاصل کیا جاتا ہے۔ تمام ویلیوز کے ساتھ ذریعہ، سال اور استعمال کی شرائط منسلک ہوتی ہیں۔ ■ انسٹالیشن صارفین ریلیزز سے اپنے پلیٹ فارم کے مطابق .mcpb فائل (macOS Apple Silicon/Intel تقریباً 40-44MB، Windows x64 تقریباً 43MB) ڈاؤن لوڈ کر کے اسے Claude Desktop کی سیٹنگز میں Extensions اسکرین پر ڈریگ اینڈ ڈراپ کر سکتے ہیں۔ اس میں پائتھون رن ٹائم شامل ہے، اس لیے پائتھون یا کسی ڈویلپمنٹ ٹول کی ضرورت نہیں ہے۔ ChatGPT کے لیے Codex (CLI, IDE extension, App) کے ذریعے 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 (تمام فہرست شدہ کمپنیوں کا گریڈ اسکرینر)، ghg_emissions (کمپنی کے اخراجات اور 5 سالہ رجحان)، ghg_industry (صنعت کے لحاظ سے اخراجات کی رینکنگ)، ghg_national_inventory (1990 سے قومی انوینٹری ٹائم سیریز)۔ ■ پڑھنے کے لیے احتیاط مختلف اداروں کے گریڈ اسکیلز مختلف ہوتے ہیں (مثلاً KCGS S~D، MSCI AAA~CCC)، اس لیے انہیں براہ راست موازنہ نہ کرنے کی ہدایت کی گئی ہے۔ '-' کا مطلب غیر درجہ بند ہے، نہ کہ صفر یا برا گریڈ۔ صنعتوں کی درجہ بندی GICS، پورٹل اور GIR کے درمیان مختلف ہو سکتی ہے۔ KOSDAQ کے لیے صرف گریڈ ٹیبل دستیاب ہے۔ گورننس کے لیے KRX ڈیٹا اور کمپنی کے اصل متن دونوں فراہم کیے جاتے ہیں۔ گرین ہاؤس گیس کے لیے ویلیو سے پہلے اس کی حد (Scope 2 طریقہ، NF₃ کی شمولیت) بتائی جاتی ہے۔ PDF سے ٹیبل نکالنا تجرباتی ہے اور امیج PDF کو OCR کے بغیر نہیں پڑھا جا سکتا۔ ■ لائسنس کی احتیاط کوڈ Apache-2.0 لائسنس کے تحت ہے، جس کا مطلب ہے کہ اسے تجارتی مقاصد سمیت آزادانہ طور پر استعمال اور تقسیم کیا جا سکتا ہے بشرطیکہ ذریعہ ظاہر کیا جائے۔ تاہم، یہ لائسنس سرور کے ذریعے حاصل کردہ ڈیٹا پر لاگو نہیں ہوتا۔ ESG گریڈز متعلقہ اداروں کی ملکیت ہیں اور ان کی عوامی تقسیم ممنوع ہے، لہذا گریڈز کو جمع کرنے، محفوظ کرنے یا فروخت کرنے کے لیے متعلقہ اداروں سے رابطہ کرنا ضروری ہے۔ اسی لیے سرور گریڈز کو میموری کیش کے علاوہ کہیں محفوظ نہیں کرتا۔ ■ ڈویلپرز کے لیے uv کے ذریعے ڈیپینڈنسز انسٹال کرنے کے بعد اسے python -m open_esg_korea (HTTP, localhost:8000/mcp) یا --transport stdio کے ذریعے چلایا جا سکتا ہے اور claude_desktop_config.json میں رجسٹر کیا جا سکتا ہے۔ scripts/build_mcpb.py کے ذریعے پلیٹ فارم کے مطابق ایکسٹینشن بلڈ کی جا سکتی ہے۔ ٹیسٹنگ کے لیے pytest دستیاب ہے، اور GICS درجہ بندی، فہرست شدہ کمپنیوں کی فہرست کی اپ ڈیٹ اسکرپٹس اور KRX/KIND رسائی کی جانچ کے لیے probe/smoke اسکرپٹس بھی فراہم کی گئی ہیں۔