MCP Rigor

ทางการ

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

ดูบน mcprigor.comลองใช้ MCP นี้ผู้สนับสนุน

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

  • ตรวจสอบไฟล์ทดสอบ — ขอให้ตรวจสอบไวยากรณ์และโครงสร้างของไฟล์ .mcpr ด้วยคำสั่ง check ก่อนนำไปรันกับเซิร์ฟเวอร์

  • รันการทดสอบการยอมรับ — ดำเนินการชุดทดสอบกับเซิร์ฟเวอร์ MCP แบบโลคัลหรือแบบ Streamable HTTP โดยใช้คำสั่ง test พร้อมแสดงจำนวนผ่าน/ไม่ผ่านในผลลัพธ์

  • สร้างรายงาน HTML — สร้างไฟล์ report.html ที่แชร์ได้จากผลการรันทดสอบ เพื่อแนบไปกับตั๋วหรืองาน CI logs

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

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