MCP Rigor

公式

MCPサーバーで、AIコーディングエージェントが構築するMCPサーバーに対して決定的なテストループを提供します。自然言語で受け入れテストを書き、文言を検証し、実行し、構造化された合格/不合格結果を読み取ります。実行時にAIがテストを解釈することはありません。実行方法: npx mcprigor serve <project>。また、契約ドリフト検出とトランスポートパリティを備えた完全なCLI/CIテストフレームワークでもあります。Apache-2.0。

mcprigor.com で表示このMCPを試すスポンサー

Rigor MCPで何ができますか？

  • テストファイルの検証 — check を使用して .mcpr ファイルの構文と構造を確認してから、サーバーに対して実行します。

  • 受け入れテストの実行 — test を使用して、ローカルまたはStreamable HTTP MCPサーバーに対してテストスイートを実行し、出力に合格/不合格の件数を表示します。

  • HTMLレポートの生成 — テスト実行から共有可能な report.html アーティファクトを作成し、チケットやCIログに添付します。

  • 対話的なテスト作成 — author を使用してMCPサーバーのツール、リソース、プロンプトを発見し、検証目標に基づいてテストファイルを生成します。

  • ブラウザワークスペースの使用 — workspace を起動して、構文ハイライト、オートコンプリート、実行履歴を備えた複数のスイートを編集、検証、実行します。

ドキュメント

このガイドでは、インストールからMCPテストが1件成功するまでを説明します。

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

次のステップ