MCP Academy · पाठ

कैलकुलेटर टूल, शुरू से अंत तक

एक छोटा लेकिन पूर्ण अंकगणितीय टूल बनाएँ।

पाठ 4, कुल 4 में से13 चरण

कैलकुलेटर टूल, शुरू से अंत तक, CoddyKit पर MCP Academy का एक निःशुल्क पाठ है। यह 4 में से 4वाँ पाठ है। इस अध्ययन पथ के 3 तक कोई भी पाठ पूरा पढ़ना निःशुल्क है — इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ व्यावहारिक अभ्यास भी उपलब्ध कराता है। यह MCP Academy सीखने के मार्ग का हिस्सा है और आपकी प्रगति वेब तथा CoddyKit ऐप पर सिंक होती रहती है। MCP Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।

एक पूरा tool बनाएँ

आइए सब कुछ एक छोटे calculator tool में जोड़ें—स्पष्ट नाम से लेकर ऐसे साफ़ परिणाम तक जिस पर मॉडल भरोसा कर सके। 🧮

सर्वर से शुरुआत करें

पहले tool को रखने के लिए एक FastMCP इंस्टेंस बनाएँ। उसे एक नाम दें, ताकि क्लाइंट आपके सर्वर की पहचान कर सकें।

from mcp.server.fastmcp import FastMCP
mcp = FastMCP("calculator")

ऑपरेशन का नाम दें

सटीक नाम चुनें। हम दो संख्याएँ जोड़ेंगे, इसलिए फ़ंक्शन add आपके और मॉडल दोनों के लिए स्पष्ट है।

प्रकार वाले पैरामीटर घोषित करें

प्रकार संकेत का उपयोग करें, ताकि मॉडल टेक्स्ट के बजाय संख्याएँ भेजे। हम दो float स्वीकार करते हैं, जिससे दशमलव और पूर्ण दोनों मान लिए जा सकें।

def add(a: float, b: float) -> float:
    ...

डॉकस्ट्रिंग लिखें

डॉकस्ट्रिंग विवरण बन जाती है, इसलिए स्पष्ट रूप से बताएँ कि tool क्या करता है और क्या लौटाता है।

def add(a: float, b: float) -> float:
    """Add two numbers and return the sum."""

इसे Tool के रूप में सजाएँ

tool डेकोरेटर जोड़ें, ताकि FastMCP फ़ंक्शन को पंजीकृत करके हर जुड़े हुए क्लाइंट के लिए उपलब्ध करा सके।

@mcp.tool()
def add(a: float, b: float) -> float:
    """Add two numbers."""
    return a + b

स्पष्ट परिणाम लौटाएँ

योग लौटाना काम करता है, लेकिन लेबल वाला परिणाम मॉडल और उत्तर देखने वाले उपयोगकर्ता दोनों के लिए अधिक स्पष्ट होता है।

    return a + b

दूसरा Tool जोड़ें

हर काम के लिए एक tool रखें, इसलिए add में कई मोड भरने के बजाय अलग divide tool बनाएँ। हर tool को बुलाना सरल रहता है।

@mcp.tool()
def divide(a: float, b: float) -> float:
    return a / b

खराब इनपुट से बचाव करें

शून्य से भाग देने पर सर्वर क्रैश हो सकता है, इसलिए पहले जाँच करें और ऐसा स्पष्ट त्रुटि संदेश लौटाएँ जिसे मॉडल पढ़ और समझा सके।

    if b == 0:
        return "Error: cannot divide by zero."

सर्वर चलाएँ

अंत में run कॉल जोड़ें, ताकि फ़ाइल लॉन्च करने पर सर्वर शुरू हो जाए और stdio के माध्यम से क्लाइंट की प्रतीक्षा करे।

if __name__ == "__main__":
    mcp.run()

पूरे टूल का परीक्षण करें

इसे लॉन्च करें और किसी क्लाइंट से अपने टूल की सूची बनवाएँ। add और divide को उनके विवरणों के साथ देखना पुष्टि करता है कि कनेक्शन सही है।

त्वरित जाँच

add में मोड फ़्लैग देने के बजाय divide को अपना अलग टूल क्यों देना चाहिए?

पुनरावलोकन

आपने एक पूरा कैलकुलेटर टूल बनाया: स्पष्ट नाम, प्रकार वाले पैरामीटर, डॉकस्ट्रिंग विवरण, नियंत्रित त्रुटियाँ और ऐसा साफ़ परिणाम जिस पर मॉडल भरोसा कर सके। ✅

शुरुआत निःशुल्क

एआई शिक्षक के साथ Python सीखें — निःशुल्क

अपने ब्राउज़र में वास्तविक कोड लिखें और चलाएँ, चौबीसों घंटे एआई शिक्षक से तुरंत सहायता पाएँ, और वेब या ऐप पर वहीं से शुरू करें जहाँ आपने छोड़ा था।

पाठ्यक्रम
30
पाठ
120

अक्सर पूछे जाने वाले प्रश्न

क्या “कैलकुलेटर टूल, शुरू से अंत तक” पाठ निःशुल्क है?

हाँ — MCP Academy अध्ययन पथ के 3 तक कोई भी पाठ, जिसमें “कैलकुलेटर टूल, शुरू से अंत तक” भी शामिल है, यहाँ वेब पर पूरा पढ़ना निःशुल्क है। इसके बाद CoddyKit PRO हर पाठ अनलॉक करता है, साथ ही अंतर्निर्मित कोड संपादक और चौबीसों घंटे एआई शिक्षक के साथ इंटरैक्टिव अभ्यास भी उपलब्ध कराता है। MCP Academy पाठ्यक्रम में कुल 4 पाठ शामिल हैं।

“कैलकुलेटर टूल, शुरू से अंत तक” में मैं क्या सीखूँगा?

एक छोटा लेकिन पूर्ण अंकगणितीय टूल बनाएँ। आप ब्राउज़र में सीधे चलाए जाने वाले व्यावहारिक कोड के साथ MCP Academy का अभ्यास करते हैं, और पाठ पूरा करते समय 24/7 एआई ट्यूटर आपके प्रश्नों के उत्तर देता है।

क्या MCP Academy शुरू करने के लिए मुझे किसी अनुभव की आवश्यकता है?

पहले के अनुभव की आवश्यकता नहीं है। CoddyKit पर MCP Academy शुरुआती से लेकर उन्नत शिक्षार्थियों तक सभी के लिए व्यवस्थित किया गया है, इसलिए आप यहीं से या शुरुआत से सीखना शुरू कर सकते हैं और अपनी गति से आगे बढ़ सकते हैं। यह 4 में से 4वाँ पाठ है।

“कैलकुलेटर टूल, शुरू से अंत तक” पाठ पूरा करने में कितना समय लगता है?

CoddyKit का अधिकांश पाठ लगभग 5–10 मिनट में पूरा हो जाता है। हर पाठ छोटा और संवादात्मक है, इसलिए आप लगातार प्रगति करते हैं और वेब या ऐप पर वहीं से सीखना जारी रख सकते हैं जहाँ आपने छोड़ा था।

क्या मैं इस MCP Academy पाठ में कोड लिख और चला सकता हूँ?

हाँ। हर MCP Academy पाठ में एक अंतर्निर्मित कोड संपादक शामिल है, जिससे आप सीधे अपने ब्राउज़र में वास्तविक कोड लिख और चला सकते हैं और तुरंत एआई प्रतिक्रिया पा सकते हैं—स्थानीय सेटअप की आवश्यकता नहीं है।

इस पाठ्यक्रम के सभी पाठ

  1. टूल का नाम और विवरण सही ढंग से दें
  2. प्रकार संकेतों के साथ पैरामीटर घोषित करें
  3. उपयोगी परिणाम लौटाएँ
  4. कैलकुलेटर टूल, शुरू से अंत तक
← MCP Academy पर वापस जाएँ