MCP Rigor

resmi

Yapay zeka kodlama ajanlarına, geliştirdikleri MCP sunucuları için deterministik bir test döngüsü sağlayan MCP sunucusu: kabul testlerini doğal dilde yazın, ifadeleri doğrulayın, çalıştırın ve yapılandırılmış geçti/kaldı sonuçlarını okuyun — çalışma zamanında testleri hiçbir yapay zeka yorumlamaz. Şununla çalıştırın: npx mcprigor serve <project>. Ayrıca sözleşme sürüklenme tespiti ve taşıma eşitliği içeren tam bir CLI/CI test çerçevesi. Apache-2.0.

mcprigor.com üzerinde görüntüleBu MCP'yi deneyinSponsorlu

Rigor MCP ile neler yapabilirsiniz?

  • Test dosyalarını doğrula — Bir .mcpr dosyasının sözdizimini ve yapısını, sunucuda çalıştırmadan önce check ile kontrol etmeyi iste.

  • Kabul testlerini çalıştır — Yerel veya Streamable HTTP MCP sunucusuna karşı test kullanarak bir test paketini yürüt; çıktıda geçen/kalan sayıları gör.

  • HTML raporları oluştur — Test çalıştırmalarından paylaşılabilir bir report.html yapıtı oluştur; bunu biletlere veya CI günlüklerine ekle.

  • Testleri etkileşimli olarak yaz — Bir MCP sunucusunun araçlarını, kaynaklarını ve istemlerini keşfetmek için author kullan, ardından doğrulama hedeflerin doğrultusunda bir test dosyası oluştur.

  • Tarayıcı çalışma alanını kullan — workspace başlatarak birden fazla paketi sözdizimi vurgulama, otomatik tamamlama ve çalıştırma geçmişiyle düzenle, doğrula ve çalıştır.

Dokümantasyon

Bu kılavuz sizi kurulumdan geçen bir MCP testine kadar götürür.

1. MCP Rigor'u Kurun

Node.js 20 veya 22'ye ihtiyacınız var. MCP Rigor, npm üzerinde mcprigor olarak yayınlanmıştır — paket, çalıştırılmaya hazır derlenmiş kodla birlikte gelir, bu nedenle kaynaktan derlemenize gerek yoktur.

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

Kurulumu kontrol etmek için:

npx mcprigor --help

2. Bir test dosyası oluşturun

calculator.mcpr dosyasını oluşturun:

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 komutunu, MCP sunucunuzu başlatan komutla değiştirin.

Dağıtılmış bir Streamable HTTP sunucusu için şunu kullanın:

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

3. İfadeleri kontrol edin

npx mcprigor check calculator.mcpr

Geçerli bir dosya şunu yazdırır:

✓ calculator.mcpr looks good and is ready to run

check sunucuya bağlanmaz.

4. Testi çalıştırın

npx mcprigor test calculator.mcpr

Başarılı bir sonuç şuna benzer:

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

1 passed, 0 failed, 0 skipped, 0 blocked

5. Paylaşılabilir bir rapor oluşturun

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

report.html dosyasını açın veya bir bilete ekleyin.

6. Tarayıcı çalışma alanını deneyin

npx mcprigor workspace .

Yazdırılan yerel URL'yi açın. calculator.mcpr seçeneğini seçin — düzenleyici size sözdizimi vurgulama ve otomatik tamamlama sunar — ardından Doğrula ve ▶ Testleri Çalıştır seçeneklerini seçin. Ayrıca yeni test dosyaları oluşturabilir, onay kutularıyla aynı anda birden fazla paketi çalıştırabilir ve sonuç panelinde çalıştırma geçmişini ve eğilimleri inceleyebilirsiniz. QA çalışma alanı kılavuzuna bakın.

Araç adlarını bilmiyorsanız

server.mcpr gibi küçük bir hedef dosya oluşturun:

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

Rehberli yazmaya başlayın:

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

MCP Rigor araçları, kaynakları ve istemleri keşfeder ve neyi doğrulamak istediğinizi sorar.

Önerilen proje düzeni

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

Sonraki adımlar