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.comCoba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan Rigor MCP?

  • Validasi file tes — Minta untuk memeriksa sintaks dan struktur file .mcpr dengan check sebelum menjalankannya terhadap server.

  • Jalankan tes penerimaan — Jalankan rangkaian tes terhadap server MCP lokal atau Streamable HTTP menggunakan test, dengan jumlah lolos/gagal pada keluaran.

  • Buat laporan HTML — Buat artefak report.html yang dapat dibagikan dari hasil tes untuk dilampirkan ke tiket atau log CI.

  • Tulis tes secara interaktif — Gunakan author untuk menemukan alat, sumber daya, dan prompt server MCP, lalu buat file tes yang dipandu oleh tujuan verifikasi Anda.

  • Gunakan ruang kerja browser — Luncurkan workspace untuk mengedit, memvalidasi, dan menjalankan beberapa rangkaian tes dengan penyorotan sintaks, pelengkapan otomatis, dan riwayat eksekusi.

Dokumentasi

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

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 lulus 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