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.com

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

  • Xác thực tệp kiểm thử — Yêu cầu chạy npx mcprigor check trên tệp .mcpr để xác minh cú pháp và mức độ sẵn sàng mà không cần kết nối đến máy chủ.
  • Thực thi kiểm thử chấp nhận — Chạy npx mcprigor test với tệp .mcpr để gọi các công cụ MCP và xác nhận kết quả có cấu trúc như structuredContent.sum.
  • Tạo báo cáo HTML — Yêu cầu tạo báo cáo kiểm thử có thể chia sẻ cho ticket hoặc tạo tạo phẩm CI.
  • Khám phá công cụ qua hướng dẫn soạn thảo — Sử dụng npx mcprigor author để tự động phát hiện công cụ, tài nguyên và lời nhắc, sau đó tạo tệp kiểm thử một cách tương tác.
  • Khởi chạy không gian làm việc QA — Bắt đầu npx mcprigor 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 và lịch sử chạy.

Tài liệu

Hướng dẫn này đưa bạn từ khâu cài đặt đến một bài kiểm tra MCP vượt qua thành công.

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ả vượt qua 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 yêu cầu.

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ại 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 soạn thả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