MCP Rigor

resmi

Server MCP yang memberikan agen pengkodean AI loop pengujian deterministik untuk server MCP yang mereka bangun: tulis tes penerimaan dalam bahasa alami, validasi kata-katanya, jalankan, dan baca hasil lulus/gagal terstruktur — tanpa AI yang menafsirkan tes saat runtime. Jalankan dengan: npx mcprigor serve <project>. Juga kerangka kerja pengujian CLI/CI lengkap dengan deteksi penyimpangan kontrak dan paritas transport. Apache-2.0.

Lihat di mcprigor.com

Apa yang bisa Anda lakukan dengan Rigor MCP?

  • Validasi file pengujian — Minta untuk menjalankan npx mcprigor check pada file .mcpr untuk memverifikasi sintaks dan kesiapan tanpa terhubung ke server.
  • Jalankan pengujian penerimaan — Jalankan npx mcprigor test terhadap file .mcpr untuk memanggil alat MCP dan memeriksa hasil terstruktur seperti structuredContent.sum.
  • Buat laporan HTML — Minta untuk menghasilkan laporan pengujian yang dapat dibagikan untuk tiket atau artefak CI.
  • Temukan alat melalui penulisan terpandu — Gunakan npx mcprigor author untuk mendeteksi alat, sumber daya, dan prompt secara otomatis, lalu buat file pengujian secara interaktif.
  • Luncurkan ruang kerja QA — Mulai npx mcprigor workspace . untuk mengedit, memvalidasi, dan menjalankan beberapa rangkaian pengujian dengan penyorotan sintaks dan riwayat eksekusi.

Dokumentasi

Panduan ini membawa Anda dari instalasi hingga satu pengujian MCP yang berhasil.

1. Instal MCP Rigor

Anda memerlukan Node.js 20 atau 22. MCP Rigor diterbitkan di npm sebagai mcprigor — paket tersebut sudah menyertakan kode terkompilasi yang siap dijalankan, jadi tidak ada yang perlu dibangun dari sumber.

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

Untuk memeriksa instalasi:

npx mcprigor --help

2. Buat file pengujian

Buat 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

Ubah perintah Server menjadi perintah yang memulai server MCP Anda.

Untuk server Streamable HTTP yang sudah diterapkan, gunakan:

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

3. Periksa susunan kata

npx mcprigor check calculator.mcpr

File yang valid akan menampilkan:

✓ calculator.mcpr looks good and is ready to run

check tidak terhubung ke server.

4. Jalankan pengujian

npx mcprigor test calculator.mcpr

Hasil yang berhasil terlihat seperti:

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

1 passed, 0 failed, 0 skipped, 0 blocked

5. Buat laporan yang dapat dibagikan

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

Buka report.html atau lampirkan ke tiket.

6. Coba ruang kerja browser

npx mcprigor workspace .

Buka URL lokal yang ditampilkan. Pilih calculator.mcpr — editor memberi Anda penyorotan sintaks dan pelengkapan otomatis — lalu pilih Validasi dan ▶ Jalankan pengujian. Anda juga dapat membuat file pengujian baru, menjalankan beberapa rangkaian sekaligus dengan kotak centang, dan meninjau riwayat serta tren eksekusi di panel hasil. Lihat panduan ruang kerja QA.

Jika Anda tidak mengetahui nama alat

Buat file target kecil seperti server.mcpr:

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

Mulai penulisan terbimbing:

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

MCP Rigor menemukan alat, sumber daya, dan prompt, lalu menanyakan apa yang ingin Anda verifikasi.

Tata letak proyek yang disarankan

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

Langkah berikutnya