MCP Rigor

ทางการ

เซิร์ฟเวอร์ MCP ที่ให้เอเจนต์เขียนโค้ด AI มีลูปการทดสอบที่กำหนดผลลัพธ์ได้สำหรับเซิร์ฟเวอร์ MCP ที่พวกเขาสร้าง: เขียนการทดสอบการยอมรับในภาษาธรรมชาติ ตรวจสอบถ้อยคำ รันการทดสอบ และอ่านผลลัพธ์ผ่าน/ไม่ผ่านที่มีโครงสร้าง — ไม่มี AI ตีความการทดสอบในขณะรันไทม์ รันด้วย: npx mcprigor serve <project> ยังมีเฟรมเวิร์กการทดสอบ CLI/CI แบบเต็มรูปแบบพร้อมการตรวจจับการเบี่ยงเบนของคอนแทรกต์และความเท่าเทียมของการขนส่ง Apache-2.0

ดูบน mcprigor.com

คุณทำอะไรได้บ้างด้วย Rigor MCP?

  • ตรวจสอบไฟล์ทดสอบ — ขอให้รัน npx mcprigor check บนไฟล์ .mcpr เพื่อตรวจสอบไวยากรณ์และความพร้อมใช้งานโดยไม่ต้องเชื่อมต่อกับเซิร์ฟเวอร์
  • ดำเนินการทดสอบการยอมรับ — รัน npx mcprigor test กับไฟล์ .mcpr เพื่อเรียกใช้เครื่องมือ MCP และยืนยันผลลัพธ์ที่มีโครงสร้าง เช่น structuredContent.sum
  • สร้างรายงาน HTML — ขอให้สร้างรายงานการทดสอบที่สามารถแชร์ได้สำหรับตั๋วหรืออาร์ติแฟกต์ CI
  • ค้นพบเครื่องมือผ่านการเขียนแบบมีคำแนะนำ — ใช้ npx mcprigor author เพื่อตรวจจับเครื่องมือ ทรัพยากร และพรอมต์โดยอัตโนมัติ จากนั้นสร้างไฟล์ทดสอบแบบโต้ตอบ
  • เปิดพื้นที่ทำงาน QA — เริ่ม npx mcprigor workspace . เพื่อแก้ไข ตรวจสอบ และรันชุดทดสอบหลายชุดพร้อมการเน้นไวยากรณ์และประวัติการรัน

เอกสาร

คู่มือนี้จะพาคุณจากขั้นตอนการติดตั้งไปจนถึงการทดสอบ MCP ที่ผ่านเกณฑ์

1. ติดตั้ง MCP Rigor

คุณต้องมี Node.js เวอร์ชัน 20 หรือ 22 MCP Rigor เผยแพร่บน npm ที่ mcprigor — แพ็กเกจมาพร้อมโค้ดที่คอมไพล์พร้อมใช้งานแล้ว จึงไม่ต้อง build จากซอร์สโค้ด

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 — ตัวแก้ไขให้การเน้นไวยากรณ์และการเติมโค้ดอัตโนมัติ — จากนั้นเลือก ตรวจสอบ และ ▶ รันการทดสอบ คุณยังสามารถสร้างไฟล์ทดสอบใหม่ รันหลายชุดพร้อมกันด้วยช่องทำเครื่องหมาย และตรวจสอบประวัติการรันและแนวโน้มในแผงผลลัพธ์ ดู คู่มือเวิร์กสเปซ 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

ขั้นตอนถัดไป