প্রকল্প সম্পর্কে

open-esg-korea হলো একটি MCP (Model Context Protocol) সার্ভার যা AI ক্লায়েন্টদের প্রাকৃতিক ভাষায় দক্ষিণ কোরিয়ার তালিকাভুক্ত কোম্পানিগুলোর ESG তথ্য জিজ্ঞাসা করার সুযোগ দেয়। এটি একজন সিকিউরিটিজ অ্যানালিস্ট দ্বারা তৈরি এবং এটি open-proxy-mcp (DART ডিসক্লোজার অ্যানালাইসিস) প্রকল্পের অনুরূপ কাঠামো ব্যবহার করে। ■ ডেটার উৎস এবং পদ্ধতি এটি KRX ESG পোর্টালের ৫টি প্রতিষ্ঠানের (KCGS, MSCI, Korea ESG Institute, S&P, Sustinvest) ESG/E/S/G গ্রেড এবং কর্পোরেট গভর্ন্যান্সের মূল সূচক, KIND ডিসক্লোজারের কর্পোরেট গভর্ন্যান্স রিপোর্ট ও সাসটেইনেবিলিটি রিপোর্ট (PDF থেকে টেক্সট এক্সট্রাকশন), এবং GIR গ্রিনহাউস গ্যাস ইনভেন্টরি সেন্টারের নির্গমনের বিবরণী ও ট্রেডিং সিস্টেমের তথ্য একীভূত করে। এই তিনটি উৎসের জন্যই কোনো API কী প্রয়োজন হয় না এবং গ্রেডগুলো সংরক্ষণ না করে প্রতিটি প্রশ্নের সময় রিয়েল-টাইমে সংগ্রহ করা হয়। প্রতিটি মানের সাথে উৎস, বছর এবং ব্যবহারের শর্তাবলী যুক্ত থাকে। ■ ইনস্টলেশন রিলিজ থেকে প্ল্যাটফর্ম অনুযায়ী .mcpb ফাইল (macOS Apple Silicon/Intel প্রায় ৪০-৪৪MB, Windows x64 প্রায় ৪৩MB) ডাউনলোড করে Claude Desktop-এর সেটিংস → এক্সটেনশন স্ক্রিনে ড্র্যাগ অ্যান্ড ড্রপ করলেই ইনস্টলেশন সম্পন্ন হয়। এতে পাইথন রানটাইম বিল্ট-ইন থাকায় আলাদাভাবে পাইথন, ডেভেলপমেন্ট টুল বা API কী-র প্রয়োজন নেই। লিনাক্সের জন্য এখনও বান্ডেল নেই, তবে ChatGPT-এর ক্ষেত্রে Codex (CLI, IDE এক্সটেনশন, অ্যাপ)-এর মাধ্যমে MCP সার্ভার সংযোগের নির্দেশনা দেওয়া হয়েছে। ইনস্টলেশন ফাইলের ভেতরে রানটাইম, ডিপেন্ডেন্সি (mcp, httpx, pypdfium2, pdfplumber), সার্ভার বডি, ম্যানিফেস্ট এবং বিল্ড তথ্য অন্তর্ভুক্ত থাকে। ■ ১২টি টুল company (কোম্পানির নাম ও স্টক কোড অনুসন্ধান), esg_ratings (প্রতিষ্ঠানভিত্তিক গ্রেড এবং বিতরণ), sustainability_reports (রিপোর্ট তালিকা, যাচাইকারী প্রতিষ্ঠান, PDF লিঙ্ক), sustainability_report_text (PDF টেক্সট কিওয়ার্ড সার্চ, উদ্ধৃতি, পৃষ্ঠা ভিউ), governance_indicators (১৫টি মূল সূচকের O/X এবং কমপ্লায়েন্স রেট), governance_policies (৭৪টি পলিসি আইটেম), governance_report (রিপোর্ট মূল পাঠ্য, ২৮টি বিস্তারিত নীতির উত্তর ও অ-কমপ্লায়েন্স কারণ), esg_disclosures (ডিসক্লোজার ইতিহাস), esg_screener (পুরো মার্কেটের গ্রেড স্ক্রিনার, ২০২৫ সালের ৭৯৫টি কোম্পানি অনুযায়ী), ghg_emissions (কোম্পানিভিত্তিক নির্গমন, ৫ বছরের ট্রেন্ড, কোটার বিপরীতে নির্গমন), ghg_industry (নির্ধারিত শিল্প ও প্রতিষ্ঠানভিত্তিক নির্গমনের র‍্যাঙ্কিং), ghg_national_inventory (১৯৯০ সাল থেকে জাতীয় ইনভেন্টরি টাইম সিরিজ)। ■ ব্যবহারের সতর্কতা প্রতিটি প্রতিষ্ঠানের গ্রেডিং স্কেল ভিন্ন হওয়ায় (KCGS S~D, MSCI AAA~CCC, S&P 0-100, Sustinvest AA~E) সেগুলোকে সরাসরি তুলনা না করার পরামর্শ দেওয়া হয়েছে। '-' চিহ্নটি মানে মূল্যায়ন করা হয়নি, এটি ০ বা খারাপ গ্রেড নয়। গ্রেডগুলো মাত্র ৬-৭টি স্তরে বিভক্ত হওয়ায় অনেক কোম্পানির স্কোর একই থাকে, তাই 'শীর্ষ N%' না দেখিয়ে একই প্রতিষ্ঠানের মধ্যে গণনা করে উত্তর দেওয়া হয়। শিল্প শ্রেণিবিন্যাস GICS (২৫টি), পোর্টাল (২১টি) এবং GIR নির্ধারিত শিল্প অনুযায়ী ভিন্ন হতে পারে। KOSDAQ-এর ক্ষেত্রে শুধুমাত্র গ্রেড টেবিল পাওয়া যায়। গভর্ন্যান্সের ক্ষেত্রে KRX-এর সংগৃহীত ডেটা এবং কোম্পানির নিজস্ব মূল পাঠ্য—এই দুই স্তরে উত্তর দেওয়া হয়; মূল পাঠ্য পড়া না গেলে '০টি কমপ্লায়েন্স' না লিখে 'পড়া সম্ভব হয়নি' হিসেবে চিহ্নিত করা হয়। গ্রিনহাউস গ্যাসের ক্ষেত্রে মানের চেয়ে এর পরিধি (বাউন্ডারি, Scope 2 পদ্ধতি, NF₃ অন্তর্ভুক্তি) আগে 제시 করা হয় এবং GIR-এ ডেটা না থাকলে no_data দেখানো হয়। রিপোর্ট থেকে স্বয়ংক্রিয় টেবিল এক্সট্রাকশন পরীক্ষামূলক (মান সংরক্ষণ ৯৭.৪%, সন্দেহজনক ঘরে সতর্কবার্তা) এবং 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 দিয়ে ১২টি টুল সঠিকভাবে কাজ করছে কি না তা যাচাই করা যায়। টেস্টগুলো নেটওয়ার্ক ছাড়াই pytest দিয়ে চালানো সম্ভব। GICS শ্রেণিবিন্যাস ও তালিকাভুক্ত কোম্পানির স্ন্যাপশট আপডেট স্ক্রিপ্ট, KRX রেসপন্স স্কিমা ও KIND ডিসক্লোজার অ্যাক্সেস যাচাই করার probe/smoke স্ক্রিপ্ট এবং MCP ড্রাফট ও পরিমাপ নোটের ডকুমেন্টেশনও প্রদান করা হয়েছে।