Yowes اور MCP کے ساتھ کثیر ملکی اساتذہ کے دستاویزات بنانے والا جنریٹر تیار کریں

Yowes ایک پورٹیبل Python ایپلیکیشن ہے جو اساتذہ سے متعلق دستاویزات ہائی ریزولوشن PNG فائلوں کے طور پر تیار کرتی ہے۔ اس کا ہیڈ لیس Model Context Protocol (MCP) سرور stdio کے ذریعے دستاویزات کی تیاری فراہم کرتا ہے، جس سے اسے Claude Desktop، Hermes اور دیگر MCP کلائنٹس جیسے ایجنٹ رن ٹائمز سے استعمال کیا جا سکتا ہے۔

یہ پروجیکٹ 13 ممالک، ملک کے لحاظ سے مخصوص دستاویز کی اقسام، پیکیج میں شامل فونٹس اور پروفائل تصاویر، اور پتوں و رابطے کی تفصیلات پر مشتمل اسکول ڈیٹا کو سپورٹ کرتا ہے۔ یہ ٹیوٹوریل انسٹالیشن، سرور سیٹ اپ، MCP ٹول کے استعمال، Python انٹیگریشن اور توسیعی اختیارات کا جائزہ لیتا ہے۔

Yowes کیا کرتا ہے

Yowes استاد کے پروفائل اور منتخب اسکول سے مقامی نوعیت کی استاد سے متعلق دستاویزات تیار کرتا ہے۔ ملک کے لحاظ سے دستیاب نتائج میں ملازمت کے خطوط، استاد کے شناختی کارڈ، تدریسی لائسنس، تنخواہ کی پرچیاں، اسکول کے شناختی کارڈ، معاہدے، سرٹیفکیٹس اور دیگر دستاویزی فارمیٹس شامل ہیں۔

تیار کردہ فائلیں PNG تصاویر کے طور پر محفوظ کی جاتی ہیں۔ ایپلیکیشن میں DejaVu Sans فونٹس اور پروفائل تصاویر پیکیج میں شامل ہیں، اس لیے رن ٹائم پر یہ سسٹم فونٹس یا بیرونی تصویری اثاثوں پر منحصر نہیں ہوتی۔

سپورٹ کیے جانے والے ممالک

دستیاب ملکی کوڈز اور دستاویز کی اقسام میں شامل ہیں:

• برطانیہ: ملازمت کے خطوط، استاد کے شناختی کارڈ اور تدریسی لائسنس۔
• ریاستہائے متحدہ: ملازمت کے خطوط، استاد کے شناختی کارڈ اور تدریسی لائسنس۔
• فرانس: تقرری کے بیانات، iProf اسکرین شاٹس، ضوابط کے اقتباسات اور تدریسی سرٹیفکیٹس۔
• نیدرلینڈز: ملازمت کے معاہدے، استاد کی رجسٹریشن، DUO اعلانات اور اسکول کے شناختی کارڈ۔
• انڈونیشیا: تنخواہ کی پرچیاں، تدریسی تجربے کے خطوط، NUPTK کارڈز اور تقرری کے خطوط۔
• آسٹریلیا: دستخط شدہ اسکول کے خطوط، اسکول کے شناختی کارڈ اور تدریسی لائسنس۔
• کینیڈا: OCT کارڈز، تدریسی لائسنس اور دستخط شدہ اسکول کے خطوط۔
• اسپین: تدریسی شناختی کارڈ، دستخط شدہ اسکول کے خطوط اور ملازمت کے معاہدے۔
• ارجنٹائن: تنخواہ کی پرچیاں، ملازمت کے سرٹیفکیٹس اور دستخط شدہ اسکول کے خطوط۔
• سلوواکیہ: تنخواہ کی پرچیاں، ملازمت کے خطوط اور دستخط شدہ اسکول کے خطوط۔
• میکسیکو: تدریسی شناختی کارڈ، دستخط شدہ اسکول کے خطوط اور ملازمت کے سرٹیفکیٹس۔
• فلپائن: تدریسی شناختی کارڈ، ملازمت کے سرٹیفکیٹس اور تدریسی لائسنس۔
• تھائی لینڈ: تنخواہ کی پرچیاں اور ملازمت کے خطوط۔

ان دستاویزات کو صرف جائز ٹیسٹنگ، مظاہروں یا مجاز انتظامی ورک فلو کے لیے استعمال کریں۔ تیار کردہ دستاویزات کو سرکاری اسناد کے طور پر پیش نہیں کیا جانا چاہیے، جب تک کہ متعلقہ ادارے نے انہیں جاری اور تصدیق نہ کی ہو۔

ضروریات

Yowes کے لیے Python 3.10 یا اس کے بعد کا ورژن درکار ہے۔ اس کے بنیادی انحصارات، Pillow اور mcp، پیکیج انسٹال کرتے وقت خودکار طور پر انسٹال ہو جاتے ہیں۔

یہ پروجیکٹ Windows، Linux اور macOS کو سپورٹ کرتا ہے۔ چونکہ فونٹس اور تصاویر پیکیج میں شامل ہیں، اس لیے پیکیج شدہ ایپلیکیشن پورٹیبل رہنے کے لیے تیار کی گئی ہے۔

Yowes انسٹال کریں

wheel سے انسٹال کریں

اگر dist ڈائریکٹری میں built wheel موجود ہے تو اسے اس کمانڈ سے انسٹال کریں:

pip install dist/yowes_doc_generator-0.1.0-py3-none-any.whl

سورس سے انسٹال کریں

ترقی یا مقامی تجربات کے لیے، پروجیکٹ کو editable موڈ میں انسٹال کریں:

pip install -e .

uv کے ساتھ چلائیں

آپ پروجیکٹ کو uv کے ذریعے بھی لانچ کر سکتے ہیں:

uvx --from . yowes-mcp

پیکیج میں شامل اثاثوں کی تصدیق کریں

انسٹالیشن کے بعد، تصدیق کریں کہ پیکیج میں شامل فونٹ اور پروفائل تصویر کے ہیلپرز درست طور پر حل ہو رہے ہیں:

python -c "from countries.utils import load_font, get_profile_photo; print(load_font(30).getname()); print(get_profile_photo((280,340), person_id='x', gender='Male') is not None)"

کامیاب رن میں DejaVu Sans فونٹ کی اطلاع ملتی ہے اور پیکیج میں شامل پروفائل تصویر کے لیے True واپس آتا ہے۔

MCP سرور سے جڑیں

Yowes stdio کے ذریعے MCP پر رابطہ کرتا ہے۔ انسٹال کردہ کمانڈ اس طرح شروع کریں:

yowes-mcp

متبادل طور پر، سورس ٹری سے براہِ راست کام کرتے وقت یہ چلائیں:

python mcp_server.py

یہ عمل standard input پر MCP درخواستوں کا انتظار کرتا ہے اور جوابات standard output پر لکھتا ہے۔ اسے انٹرایکٹو ٹرمینل ایپلیکیشن کے طور پر کام کرنے کے لیے ڈیزائن نہیں کیا گیا۔

MCP کلائنٹ میں Yowes رجسٹر کریں

اپنے MCP سے مطابقت رکھنے والے ایجنٹ رن ٹائم کو executable کی طرف متوجہ کریں:

{
  "mcpServers": {
    "yowes": {
      "command": "yowes-mcp",
      "args": []
    }
  }
}

اگر کمانڈ آپ کے PATH میں دستیاب نہیں ہے تو Python کا absolute path استعمال کریں اور سرور ماڈیول چلائیں:

{
  "mcpServers": {
    "yowes": {
      "command": "/path/to/python",
      "args": ["-m", "mcp_server"]
    }
  }
}

دستیاب MCP ٹولز کا جائزہ لیں

سرور تین بنیادی ٹولز فراہم کرتا ہے:

• list_countries_tool ملکی کوڈز، دکھائے جانے والے نام اور دستاویز کی اقسام کی فہرست بناتا ہے۔
• list_schools(country) منتخب ملک کے اسکولوں کی فہرست بناتا ہے۔
• generate_documents(...) ایک یا زیادہ دستاویزات تیار کرتا ہے اور ان کے فائل پاتھ واپس کرتا ہے۔

ممالک کی فہرست بنائیں

list_countries_tool کو بغیر دلائل کے کال کریں۔ جواب میں ہر ملک کے لیے ایک نتیجہ شامل ہوتا ہے، جس میں code، name اور document_types جیسی قدریں شامل ہوتی ہیں۔ چونکہ فہرست متعدد MCP content آئٹمز میں تقسیم ہوتی ہے، اس لیے ہر ملک کا جائزہ لینے کے لیے واپس کیے گئے content کلیکشن پر iterate کریں۔

اسکولوں کی فہرست بنائیں

list_schools کو ملکی کوڈ دیں:

{
  "country": "us"
}

ہر اسکول کے نتیجے میں اس کا نام، پتہ، قصبہ، پوسٹل کوڈ، ریاست، فون نمبر اور مقامی تعلیمی اتھارٹی کی معلومات شامل ہو سکتی ہیں۔ دستاویزات تیار کرتے وقت اس ٹول سے واپس کیے گئے اسکول کے عین یا جزوی نام کا استعمال کریں۔

دستاویزات تیار کریں

generate_documents ٹول کے لیے ملک، استاد کا نام، اسکول، عہدہ اور تاریخِ پیدائش درکار ہیں۔ آپ اختیاری طور پر جنس، دستاویز کی اقسام اور آؤٹ پٹ ڈائریکٹری بھی منتخب کر سکتے ہیں۔

درخواست کی مثال

{
  "country": "us",
  "first_name": "John",
  "last_name": "Smith",
  "school_name": "Valley High",
  "position": "Head of Science Department",
  "date_of_birth": "12/05/1988",
  "gender": "Male",
  "document_types": ["employment_letter", "teacher_id"],
  "output_dir": "output"
}

gender کی قدر Random، Male یا Female ہو سکتی ہے۔ یہ بنڈل شدہ پروفائل فوٹو پول میں سے انتخاب کو کنٹرول کرتی ہے۔ اگر document_types کو چھوڑ دیا جائے تو Yowes منتخب ملک کے لیے دستیاب تمام دستاویزات تیار کرتا ہے۔ ڈیفالٹ آؤٹ پٹ ڈائریکٹری output/ ہے۔

کامیاب جواب میں منتخب ملک اور اسکول، دستاویز کی اقسام، تیار کردہ فائل پاتھ، تعداد اور آؤٹ پٹ ڈائریکٹری شامل ہوتی ہے۔ واپس کیے گئے PNG پاتھ مطلق پاتھ ہوتے ہیں۔

مثال کے طور پر، امریکہ کی تیار کردہ دستاویزات درج ذیل نمونہ آؤٹ پٹس سے مشابہ ہو سکتی ہیں:

Python سے Yowes استعمال کریں

ایپلیکیشنز MCP سرور شروع کر کے Python MCP کلائنٹ کے ذریعے اس کے ٹولز استعمال کر سکتی ہیں۔ ضرورت ہو تو کلائنٹ کی dependency انسٹال کریں:

pip install mcp

درج ذیل مثال stdio سیشن شروع کرتی ہے، ممالک کی فہرست حاصل کرتی ہے اور امریکہ کی دستاویزات تیار کرتی ہے:

import asyncio
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def main():
    params = StdioServerParameters(command="yowes-mcp", args=[])
    async with stdio_client(params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()

            countries = await session.call_tool(
                "list_countries_tool", {}
            )
            for item in countries.content:
                print(item.text)

            result = await session.call_tool(
                "generate_documents",
                {
                    "country": "us",
                    "first_name": "John",
                    "last_name": "Smith",
                    "school_name": "Valley High",
                    "position": "Head of Science Department",
                    "date_of_birth": "12/05/1988",
                    "gender": "Male"
                }
            )
            print(result.content[0].text)

asyncio.run(main())

چونکہ فہرست کے جوابات الگ الگ مواد کے آئٹمز میں تقسیم ہوتے ہیں، اس لیے countries.content کے ہر آئٹم کا معائنہ کریں، یہ فرض نہ کریں کہ پوری فہرست ایک ہی جوابی قدر میں موجود ہو گی۔

ایک عملی ایجنٹ ورک فلو

1. درست ملک کوڈز اور دستاویز کی اقسام دریافت کرنے کے لیے list_countries_tool کال کریں۔
2. منتخب ملک کوڈ کے ساتھ list_schools کال کریں۔
3. واپس کیے گئے ڈیٹا میں سے ایک اسکول منتخب کریں۔
4. مجاز استاد اور اسکول کی معلومات کے ساتھ generate_documents کال کریں۔
5. واپس کیے گئے PNG پاتھ پڑھیں اور اپنی ایپلیکیشن میں فائلوں پر کارروائی کریں۔

یہ ترتیب ملک کوڈز، اسکول کے ناموں یا دستاویز کی قسم کے شناخت کنندگان کا اندازہ لگانے سے بچاتی ہے۔

اعلیٰ درجے کی تجاویز

صرف مطلوبہ آؤٹ پٹس منتخب کریں

جب آپ کو کسی ملک کی دستیاب دستاویزات میں سے صرف کچھ درکار ہوں تو document_types ارے فراہم کریں۔ اس سے غیر ضروری رینڈرنگ کم ہوتی ہے اور آؤٹ پٹ ڈائریکٹری مطلوبہ فائلوں تک محدود رہتی ہے۔

مستحکم پروفائل فوٹو منتخب کریں

Yowes ایک ہی شخص کے لیے پروفائل فوٹوز کو مستقل رکھنے کے لیے ہیش پر مبنی انتخاب استعمال کرتا ہے۔ مستحکم شخصی شناخت اور واضح جنس فراہم کرنے سے مناسب بنڈل شدہ فوٹو پول میں سے قابلِ پیش گوئی نتائج حاصل کرنے میں مدد ملتی ہے۔

حسبِ ضرورت آؤٹ پٹ ڈائریکٹری استعمال کریں

تیار کردہ تصاویر کو پروجیکٹ، ٹیسٹ رن یا ملک کے لحاظ سے منظم کرنے کے لیے output_dir مقرر کریں۔ نسبتی پاتھ MCP سرور کی ورکنگ ڈائریکٹری سے حل کیے جاتے ہیں۔

ضرورت پڑنے پر پرانا GUI چلائیں

پروجیکٹ میں ایک اختیاری CustomTkinter انٹرفیس بھی شامل ہے جو بنیادی جنریشن لاجک استعمال کرتا ہے:

python main_gui.py

Windows پر repository میں run.bat بھی فراہم کی گئی ہے، جو TCL_LIBRARY مقرر کرتی ہے۔ MCP سرور بنیادی headless انٹرفیس ہے اور GUI پر منحصر نہیں ہے۔

Yowes میں نیا ملک شامل کریں

ملک شامل کرنے کے لیے countries/<code>/__init__.py بنائیں اور ایسی کلاس کی تعریف کریں جو countries.base.CountryGenerator سے وراثت لے۔ مطلوبہ طریقے نافذ کریں:

• get_country_name
• get_country_code
• get_schools_data
• get_first_names
• get_last_names
• get_positions
• get_document_types
• generate_document

جنریٹر کو countries/__init__.py میں register_country("<code>", <Name>Generator) کے ساتھ رجسٹر کریں۔ رجسٹر ہونے کے بعد MCP کے ملک اور اسکول کے ٹولز اسے خودکار طور پر دریافت کر سکتے ہیں۔ اگر GUI میں حسبِ ضرورت لیبل دکھانا ہو تو main_gui.py میں اس کی ملک فہرست اور ملک تبدیل کرنے کی منطق کو اپ ڈیٹ کریں۔

نتیجہ

Yowes ملک کے لحاظ سے مخصوص دستاویز جنریٹرز، بنڈل شدہ اثاثوں، اور ایک MCP stdio سرور کو ایک قابلِ نقل ورک فلو میں یکجا کرتا ہے۔ اسے Python کے ساتھ انسٹال کریں، MCP کے ذریعے دستیاب ممالک اور اسکولز دریافت کریں، منتخب PNG آؤٹ پٹس تیار کریں، اور اس عمل کو کسی ایجنٹ یا Python ایپلیکیشن میں ضم کریں۔ جائز ڈویلپمنٹ اور ٹیسٹنگ کے لیے، اس کا ملک رجسٹریشن پیٹرن نئے جنریٹرز شامل کرنے کا ایک واضح طریقہ بھی فراہم کرتا ہے۔