MCP Rigor

공식

AI 코딩 에이전트가 구축한 MCP 서버에 결정적 테스트 루프를 제공하는 MCP 서버: 자연어로 승인 테스트를 작성하고, 문구를 검증하고, 실행하며, 구조화된 통과/실패 결과를 읽습니다 — 런타임에 AI가 테스트를 해석하지 않습니다. 실행: npx mcprigor serve <project>. 또한 계약 드리프트 감지 및 전송 패리티를 갖춘 전체 CLI/CI 테스트 프레임워크입니다. Apache-2.0.

mcprigor.com에서 보기이 MCP 사용해 보기스폰서

Rigor MCP(으)로 무엇을 할 수 있나요?

  • 테스트 파일 검증 — .mcpr 파일에 대해 npx mcprigor check를 실행하여 서버에 연결하지 않고 구문과 준비 상태를 확인하도록 요청합니다.
  • 승인 테스트 실행 — .mcpr 파일에 대해 npx mcprigor test를 실행하여 MCP 도구를 호출하고 structuredContent.sum과 같은 구조화된 결과에 대해 검증합니다.
  • HTML 보고서 생성 — npx mcprigor test --html report.html을 요청하여 티켓이나 CI 아티팩트용으로 공유 가능한 테스트 보고서를 생성합니다.
  • 가이드 작성을 통한 도구 발견 — npx mcprigor author를 사용하여 도구, 리소스, 프롬프트를 자동 감지한 후 대화형으로 테스트 파일을 생성합니다.
  • QA 작업 공간 실행 — npx mcprigor workspace .를 시작하여 구문 강조와 실행 기록을 통해 여러 테스트 스위트를 편집, 검증, 실행합니다.

문서

이 가이드는 설치부터 MCP 테스트 통과까지 안내합니다.

1. MCP Rigor 설치

Node.js 20 또는 22가 필요합니다. MCP Rigor는 npm에 mcprigor로 게시되어 있습니다 — 패키지에는 바로 실행 가능한 컴파일된 코드가 포함되어 있어 소스에서 빌드할 필요가 없습니다.

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

설치를 확인하려면:

npx mcprigor --help

2. 테스트 파일 만들기

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

Server 명령을 MCP 서버를 시작하는 명령으로 변경하세요.

배포된 Streamable HTTP 서버의 경우 다음을 사용하세요:

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

3. 문구 확인

npx mcprigor check calculator.mcpr

유효한 파일은 다음을 출력합니다:

✓ calculator.mcpr looks good and is ready to run

check는 서버에 연결하지 않습니다.

4. 테스트 실행

npx mcprigor test calculator.mcpr

통과 결과는 다음과 같습니다:

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

1 passed, 0 failed, 0 skipped, 0 blocked

5. 공유 가능한 보고서 만들기

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

report.html을 열거나 티켓에 첨부하세요.

6. 브라우저 작업 공간 사용해 보기

npx mcprigor workspace .

출력된 로컬 URL을 여세요. calculator.mcpr을 선택하세요 — 편집기에서 구문 강조와 자동 완성을 제공합니다 — 그런 다음 Validate 및 ▶ Run tests를 선택하세요. 새 테스트 파일을 만들고, 체크박스로 여러 스위트를 동시에 실행하며, 결과 패널에서 실행 기록과 추세를 검토할 수도 있습니다. QA 작업 공간 가이드를 참조하세요.

도구 이름을 모르는 경우

server.mcpr 같은 작은 대상 파일을 만드세요:

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

안내식 작성 시작:

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

MCP Rigor는 도구, 리소스, 프롬프트를 발견하고 무엇을 검증할지 질문합니다.

권장 프로젝트 구조

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

다음 단계