MCP Rigor

chính thức

MCP server cung cấp cho các tác nhân mã hóa AI một vòng lặp kiểm thử xác định cho các MCP server mà chúng xây dựng: viết bài kiểm thử chấp nhận bằng ngôn ngữ tự nhiên, xác thực cách diễn đạt, chạy chúng, và đọc kết quả đạt/không đạt có cấu trúc — không có AI nào diễn giải bài kiểm thử tại thời điểm chạy. Chạy với: npx mcprigor serve <project>. Cũng là một framework kiểm thử CLI/CI đầy đủ với phát hiện lệch hợp đồng và tương đương vận chuyển. Apache-2.0.

Xem trên mcprigor.comDùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Rigor MCP?

  • Xác thực tệp kiểm thử — Yêu cầu kiểm tra cú pháp và cấu trúc của tệp .mcpr bằng check trước khi chạy nó với máy chủ.

  • Chạy kiểm thử chấp nhận — Thực thi một bộ kiểm thử với máy chủ MCP cục bộ hoặc Streamable HTTP bằng test, với số lượng đạt/không đạt trong đầu ra.

  • Tạo báo cáo HTML — Tạo một tệp report.html có thể chia sẻ từ các lần chạy kiểm thử để đính kèm vào ticket hoặc nhật ký CI.

  • Soạn kiểm thử tương tác — Sử dụng author để khám phá các công cụ, tài nguyên và lời nhắc của máy chủ MCP, sau đó tạo tệp kiểm thử theo hướng dẫn từ mục tiêu xác minh của bạn.

  • Sử dụng không gian làm việc trình duyệt — Khởi chạy workspace để chỉnh sửa, xác thực và chạy nhiều bộ kiểm thử với tô sáng cú pháp, tự động hoàn thành và lịch sử chạy.

Tài liệu

Hướng dẫn này đưa bạn từ lúc cài đặt đến khi vượt qua một bài kiểm tra MCP.

1. Cài đặt MCP Rigor

Bạn cần Node.js 20 hoặc 22. MCP Rigor được phát hành trên npm dưới dạng mcprigor — gói này đi kèm mã đã biên dịch sẵn sàng chạy, vì vậy không cần xây dựng từ mã nguồn.

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

Để kiểm tra cài đặt:

npx mcprigor --help

2. Tạo tệp kiểm tra

Tạo 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

Thay đổi lệnh Server thành lệnh khởi động máy chủ MCP của bạn.

Đối với máy chủ Streamable HTTP đã triển khai, hãy sử dụng:

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

3. Kiểm tra cách diễn đạt

npx mcprigor check calculator.mcpr

Một tệp hợp lệ sẽ in ra:

✓ calculator.mcpr looks good and is ready to run

check không kết nối với máy chủ.

4. Chạy bài kiểm tra

npx mcprigor test calculator.mcpr

Kết quả đạt trông như sau:

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

1 passed, 0 failed, 0 skipped, 0 blocked

5. Tạo báo cáo có thể chia sẻ

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

Mở report.html hoặc đính kèm nó vào một phiếu hỗ trợ.

6. Thử không gian làm việc trình duyệt

npx mcprigor workspace .

Mở URL cục bộ đã in. Chọn calculator.mcpr — trình soạn thảo cung cấp tô sáng cú pháp và tự động hoàn thành — sau đó chọn Validate và ▶ Run tests. Bạn cũng có thể tạo tệp kiểm tra mới, chạy nhiều bộ kiểm tra cùng lúc bằng hộp kiểm, và xem lịch sử chạy cùng xu hướng trong bảng kết quả. Xem hướng dẫn không gian làm việc QA.

Nếu bạn không biết tên công cụ

Tạo một tệp mục tiêu nhỏ như server.mcpr:

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

Bắt đầu tạo có hướng dẫn:

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

MCP Rigor khám phá các công cụ, tài nguyên và lời nhắc, sau đó hỏi bạn muốn xác minh điều gì.

Bố cục dự án được khuyến nghị

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

Các bước tiếp theo