MCP Rigor

यह मार्गदर्शिका आपको इंस्टॉलेशन से लेकर एक सफल MCP परीक्षण तक ले जाती है।

1. MCP Rigor इंस्टॉल करें

आपको Node.js 20 या 22 की आवश्यकता है। MCP Rigor npm पर mcprigor के रूप में प्रकाशित है — पैकेज में तैयार-से-चलने वाला संकलित कोड शामिल है, इसलिए स्रोत से बनाने के लिए कुछ भी नहीं है।

mkdir mcp-acceptance-tests
cd mcp-acceptance-tests
npm init -y
npm install mcprigor

इंस्टॉलेशन की जाँच करने के लिए:

npx mcprigor --help

2. एक परीक्षण फ़ाइल बनाएँ

calculator.mcpr बनाएँ:

MCP Test 1

Suite: "Calculator acceptance tests"
Server: node ../calculator-server/dist/server.js

Test: "Adding 20 and 22 gives 42"
  Call tool "add" with:
    a: 20
    b: 22

  Expect "structuredContent.sum" equals 42

Server कमांड को उस कमांड में बदलें जो आपके MCP सर्वर को शुरू करता है।

तैनात Streamable HTTP सर्वर के लिए, उपयोग करें:

MCP URL: https://qa.example.com/mcp

3. शब्दावली की जाँच करें

npx mcprigor check calculator.mcpr

एक मान्य फ़ाइल प्रिंट करती है:

✓ calculator.mcpr looks good and is ready to run

check सर्वर से कनेक्ट नहीं होता है।

4. परीक्षण चलाएँ

npx mcprigor test calculator.mcpr

एक सफल परिणाम इस प्रकार दिखता है:

MCP Rigor — Calculator acceptance tests
✓ Adding 20 and 22 gives 42

1 passed, 0 failed, 0 skipped, 0 blocked

5. एक साझा करने योग्य रिपोर्ट बनाएँ

npx mcprigor test calculator.mcpr --html report.html

report.html खोलें या इसे किसी टिकट से संलग्न करें।

6. ब्राउज़र वर्कस्पेस आज़माएँ

npx mcprigor workspace .

मुद्रित स्थानीय URL खोलें। calculator.mcpr चुनें — संपादक आपको सिंटैक्स हाइलाइटिंग और ऑटोकम्प्लीट देता है — फिर Validate और ▶ Run tests चुनें। आप नई परीक्षण फ़ाइलें भी बना सकते हैं, चेकबॉक्स के साथ एक साथ कई सूट चला सकते हैं, और परिणाम पैनल में रन इतिहास और रुझानों की समीक्षा कर सकते हैं। QA वर्कस्पेस मार्गदर्शिका देखें।

यदि आप टूल नाम नहीं जानते हैं

server.mcpr जैसी एक छोटी लक्ष्य फ़ाइल बनाएँ:

MCP Test 1
Suite: "Server target"
Server: node ../calculator-server/dist/server.js
Test: "Connection"
  Send "ping"

निर्देशित लेखन शुरू करें:

npx mcprigor author server.mcpr --out calculator.mcpr

MCP Rigor टूल, संसाधनों और प्रॉम्प्ट की खोज करता है और पूछता है कि आप क्या सत्यापित करना चाहते हैं।

अनुशंसित प्रोजेक्ट लेआउट

mcp-acceptance-tests/
  package.json
  tests/
    smoke.mcpr
    regression.mcpr
    data/
      customers.csv
  .mcprigor/
    # generated evidence; normally ignored or stored as CI artifacts

अगले कदम

• प्राकृतिक-भाषा कुकबुक
• QA वर्कस्पेस
• इंजीनियर सेटअप और CI
• समस्या निवारण