MCP Rigor

आधिकारिक

एमसीपी सर्वर जो एआई कोडिंग एजेंटों को उनके द्वारा बनाए गए एमसीपी सर्वरों के लिए एक निर्धारित परीक्षण लूप देता है: प्राकृतिक भाषा में स्वीकृति परीक्षण लिखें, शब्दों को मान्य करें, उन्हें चलाएं, और संरचित पास/फेल परिणाम पढ़ें — रनटाइम पर कोई एआई परीक्षणों की व्याख्या नहीं करता। इसके साथ चलाएं: npx mcprigor serve <project>. साथ ही अनुबंध बहाव पहचान और परिवहन समानता के साथ एक पूर्ण CLI/CI परीक्षण ढांचा। Apache-2.0।

Rigor MCP के साथ आप क्या कर सकते हैं?

  • टेस्ट फ़ाइलों को मान्य करें — किसी सर्वर के विरुद्ध चलाने से पहले check के साथ .mcpr फ़ाइल के सिंटैक्स और संरचना की जाँच करने के लिए कहें।

  • स्वीकृति परीक्षण चलाएँtest का उपयोग करके किसी स्थानीय या स्ट्रीमेबल HTTP MCP सर्वर के विरुद्ध एक परीक्षण सूट निष्पादित करें, जिसमें आउटपुट में पास/फेल की संख्या शामिल हो।

  • HTML रिपोर्ट उत्पन्न करें — परीक्षण रन से एक साझा करने योग्य report.html आर्टिफैक्ट बनाएँ, जिसे टिकट या CI लॉग से जोड़ा जा सके।

  • परीक्षण इंटरैक्टिव रूप से लिखेंauthor का उपयोग करके MCP सर्वर के टूल, संसाधनों और प्रॉम्प्ट की खोज करें, फिर अपने सत्यापन लक्ष्यों द्वारा निर्देशित एक परीक्षण फ़ाइल उत्पन्न करें।

  • ब्राउज़र वर्कस्पेस का उपयोग करेंworkspace लॉन्च करके सिंटैक्स हाइलाइटिंग, ऑटोकम्प्लीट और रन इतिहास के साथ कई सूट संपादित, मान्य और चलाएँ।

दस्तावेज़

यह गाइड आपको इंस्टॉलेशन से लेकर एक सफल 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

अगले कदम