MCP Rigor

公式

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

mcprigor.com で表示

Rigor MCPで何ができますか？

  • テストファイルの検証 — .mcpr ファイルに対して npx mcprigor check を実行し、サーバーに接続せずに構文と準備状態を確認するよう依頼します。
  • 受け入れテストの実行 — .mcpr ファイルに対して npx mcprigor test を実行し、MCP ツールを呼び出して、structuredContent.sum などの構造化された結果に対してアサーションを行います。
  • HTML レポートの生成 — チケットや CI アーティファクト用に共有可能なテストレポートを作成するよう依頼します。
  • ガイド付きオーサリングによるツールの検出 — npx mcprigor author を使用してツール、リソース、プロンプトを自動検出し、対話的にテストファイルを生成します。
  • QA ワークスペースの起動 — npx mcprigor 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

次のステップ