The server inspector

MCP सर्वर टेस्टिंग और डीबगिंग (MCP Server Testing and Debugging)

यह नोट्स MCP सर्वर की कार्यक्षमता की जाँच करने के लिए उपयोग किए जाने वाले इन-ब्राउज़र डीबगर (MCP Inspector) के उपयोग पर आधारित हैं।

मुख्य अवधारणाएँ:

• उद्देश्य: MCP सर्वर की कार्यक्षमता को वास्तविक एप्लिकेशन से जोड़ने की आवश्यकता के बिना लाइव विकसित (live develop) और डीबग करना।
• उपकरण: Python SDK का उपयोग करके प्राप्त इन-ब्राउज़र डीबगर (MCP Inspector)।

MCP सर्वर सेटअप और रन करना:

• पर्यावरण सक्रियण: सुनिश्चित करें कि Python वातावरण सक्रिय (activated) है (इसके लिए readme दस्तावेज़ देखें)।
• सर्वर शुरू करना: टर्मिनल में कमांड चलाएँ: mcp dev [सर्वर फ़ाइल का नाम] (उदाहरण: mcpserver. py)।
• पहुँच: सर्वर शुरू होने पर, आपको एक पोर्ट (जैसे 6277) और एक डायरेक्ट एड्रेस प्राप्त होगा। इस एड्रेस को ब्राउज़र में खोलें।
• MCP इंस्पेक्टर: ब्राउज़र में खुलने वाला इंटरफ़ेस MCP इंस्पेक्टर है।

MCP इंस्पेक्टर का उपयोग (MCP Inspector Usage):

• कनेक्ट बटन: बाईं ओर स्थित 'Connect' बटन सर्वर को शुरू करता है।
• नेविगेशन: शीर्ष मेनू बार में 'Tools' सेक्शन पर जाएँ।
• टूल सूची: 'Tools' सेक्शन के अंदर 'List Tools' पर क्लिक करें ताकि आपके द्वारा बनाए गए सभी टूल्स की सूची दिखाई दे।
• मैनुअल इन्वोक: दाईं ओर का पैनल उस टूल को मैन्युअल रूप से चलाने (invoke) के लिए उपयोग किया जाता है, जिससे यह सुनिश्चित होता है कि टूल सही ढंग से काम कर रहा है।

टूल टेस्टिंग की प्रक्रिया (Tool Testing Workflow):

• Read Doc Contents Tool:
• कार्य: दस्तावेज़ की सामग्री पढ़ना।
• प्रक्रिया: एक 'Document ID' दर्ज करें → 'Run Tool' पर क्लिक करें → आउटपुट की तुलना अपेक्षित सामग्री से करें।
• Edit Document Tool:
• कार्य: दस्तावेज़ की सामग्री को बदलना।
• प्रक्रिया: 'Document ID' और 'Old String' (पुरानी स्ट्रिंग) दर्ज करें → 'New String' (नई स्ट्रिंग) दर्ज करें → 'Run Tool' पर क्लिक करें।
• ध्यान दें: यह टूल केवल संपादन करता है, यह दस्तावेज़ की सामग्री वापस नहीं लौटाता।
• सत्यापन (Verification): संपादन की पुष्टि करने के लिए, उसी 'Document ID' का उपयोग करके 'Read Doc Contents Tool' को दोबारा चलाएँ।

Takeaways

• MCP इंस्पेक्टर का उपयोग वास्तविक एप्लिकेशन से जुड़े बिना MCP सर्वर की कार्यक्षमता को लाइव विकसित (live develop) और डीबग करने के लिए किया जाता है।
• सर्वर शुरू करने के लिए टर्मिनल में mcp dev कमांड चलाएँ और ब्राउज़र में दिए गए पोर्ट/एड्रेस पर MCP इंस्पेक्टर एक्सेस करें।
• टूल्स की सूची देखने के लिए MCP इंस्पेक्टर के 'Tools' सेक्शन में 'List Tools' पर क्लिक करें।
• टूल टेस्टिंग वर्कफ़्लो: पहले 'Read Doc Contents Tool' से सामग्री पढ़ें, फिर 'Edit Document Tool' से बदलाव करें, और अंत में सत्यापन के लिए 'Read Doc Contents Tool' को दोबारा चलाएँ।