README.md

بنیادی کیلکولیٹر MCP سروس

یہ سروس ماڈل کانٹیکسٹ پروٹوکول (MCP) کے ذریعے بنیادی کیلکولیٹر آپریشنز فراہم کرتی ہے، جو Spring Boot کے WebFlux ٹرانسپورٹ کے ساتھ کام کرتی ہے۔ یہ نئے سیکھنے والوں کے لیے MCP کی امپلیمنٹیشنز کا ایک آسان مثال کے طور پر ڈیزائن کی گئی ہے۔

مزید معلومات کے لیے، MCP Server Boot Starter کی ریفرنس ڈاکیومنٹیشن دیکھیں۔

سروس کا استعمال

یہ سروس MCP پروٹوکول کے ذریعے درج ذیل API اینڈپوائنٹس فراہم کرتی ہے:

• add(a, b): دو نمبروں کو جمع کریں
• subtract(a, b): دوسرے نمبر کو پہلے نمبر سے منفی کریں
• multiply(a, b): دو نمبروں کو ضرب دیں
• divide(a, b): پہلے نمبر کو دوسرے نمبر سے تقسیم کریں (زیرو چیک کے ساتھ)
• power(base, exponent): کسی نمبر کی طاقت نکالیں
• squareRoot(number): مربع جذر نکالیں (منفی نمبر چیک کے ساتھ)
• modulus(a, b): تقسیم کے بعد باقی بچا ہوا حصہ نکالیں
• absolute(number): عدد کی قدر کا مطلقہ نکالیں

انحصارات

پروجیکٹ کے لیے درج ذیل اہم انحصارات درکار ہیں:

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-mcp-server-webflux</artifactId>
</dependency>

پروجیکٹ کی تعمیر

Maven استعمال کرتے ہوئے پروجیکٹ بنائیں:

./mvnw clean install -DskipTests

سرور چلانا

جاوا استعمال کرتے ہوئے

java -jar target/calculator-server-0.0.1-SNAPSHOT.jar

MCP Inspector استعمال کرنا

MCP Inspector ایک مددگار ٹول ہے جو MCP سروسز کے ساتھ تعامل کے لیے استعمال ہوتا ہے۔ اس کیلکولیٹر سروس کے ساتھ اسے استعمال کرنے کے لیے:

1. MCP Inspector انسٹال کریں اور ایک نئے ٹرمینل ونڈو میں چلائیں:

   npx @modelcontextprotocol/inspector

2. ویب UI تک رسائی حاصل کریں، جو ایپ کی طرف سے دکھائی گئی URL پر کلک کر کے (عام طور پر http://localhost:6274)

3. کنکشن کی ترتیب دیں:

   • ٹرانسپورٹ کی قسم "SSE" منتخب کریں
   • URL اپنے چلتے ہوئے سرور کے SSE اینڈپوائنٹ پر سیٹ کریں: http://localhost:8080/sse
   • "Connect" پر کلک کریں

4. ٹولز استعمال کریں:

   • "List Tools" پر کلک کریں تاکہ دستیاب کیلکولیٹر آپریشنز دیکھ سکیں
   • کوئی ٹول منتخب کریں اور "Run Tool" پر کلک کر کے آپریشن چلائیں

دستخطی نوٹ:
یہ دستاویز AI ترجمہ سروس Co-op Translator کے ذریعے ترجمہ کی گئی ہے۔ اگرچہ ہم درستگی کے لیے کوشاں ہیں، براہ کرم اس بات سے آگاہ رہیں کہ خودکار ترجمے میں غلطیاں یا عدم درستیاں ہو سکتی ہیں۔ اصل دستاویز اپنی مادری زبان میں ہی معتبر ماخذ سمجھی جانی چاہیے۔ اہم معلومات کے لیے پیشہ ور انسانی ترجمہ کی سفارش کی جاتی ہے۔ اس ترجمے کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تشریح کی ذمہ داری ہم پر عائد نہیں ہوتی۔