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üle

Rigor MCP ile neler yapabilirsiniz?

  • Test dosyalarını doğrula — Bir .mcpr dosyasında npx mcprigor check çalıştırmayı isteyerek, sunucuya bağlanmadan sözdizimini ve hazır olma durumunu doğrulayın.
  • Kabul testlerini çalıştır — Bir .mcpr dosyasına karşı npx mcprigor test çalıştırarak MCP araçlarını çağırın ve structuredContent.sum gibi yapılandırılmış sonuçlar üzerinde iddialarda bulunun.
  • HTML raporları oluştur — Biletler veya CI yapıtları için paylaşılabilir bir test raporu üretmeyi isteyin.
  • Rehberli yazım ile araçları keşfet — Araçları, kaynakları ve istemleri otomatik algılamak için npx mcprigor author kullanın, ardından etkileşimli olarak bir test dosyası oluşturun.
  • QA çalışma alanını başlat — Sözdizimi vurgulama ve çalıştırma geçmişi ile birden fazla test paketini düzenlemek, doğrulamak ve çalıştırmak için npx mcprigor workspace . başlatın.

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 gereklidir. MCP Rigor, npm üzerinde mcprigor olarak yayınlanmıştır — paket, çalıştırılmaya hazır derlenmiş kodla birlikte gelir, bu nedenle kaynaktan derleme yapmanıza 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. İfadeyi 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 yazımı başlatı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