proctor

Proctor MCP サーバー

MCP についてまだご存じない方は、最新情報を得るために PulseMCP の週刊ニュースレターをご覧ください。

---

これは、MCP サーバーに対して Proctor 試験を実行するための MCP（Model Context Protocol）サーバーです。PulseMCP Proctor APIと直接連携し、テストの実行、試験インフラの管理、テスト結果の追跡を行うツールを提供します。

注：これは PulseMCP チーム向けの内部ツールです。ソースコードは参照用に公開されていますが、このサーバーには一般公開されていない API キーが必要です。

目次

• 主な特長
• 機能
• ツールグループ
• 使用上のヒント
• 例
• セットアップ
  • チートシート
  • Claude Desktop
    • 手動セットアップ

主な特長

試験の実行：MCP サーバーに対して Proctor 試験を実行し、機能とプロトコルへの準拠をテストします。

結果の管理：比較テストやリグレッションテストに使用する試験結果を保存、取得します。

インフラの制御：試験の実行に使用する Fly.io マシンの一覧表示、管理、クリーンアップを行います。

ツールグループ：TOOL_GROUPS 環境変数を使ってツールグループを有効または無効にできます。各グループには、基本バリアント（フルアクセス）と_readonlyバリアント（読み取り専用アクセス）があります。

結果のストリーミング：NDJSON ストリーミングによるリアルタイムの試験実行ログを利用できます。

機能

このサーバーは、Claude Desktop を使用して macOS 上で構築およびテストされています。他の MCP クライアントでも動作するはずです。

ツール名	ツールグループ	読み取り／書き込み	説明
get_proctor_metadata	exams	読み取り	Proctor テストで利用可能なランタイムと試験を取得します。
run_exam	exams	書き込み	MCP サーバーに対して Proctor 試験を実行します。
get_machines	machines	読み取り	Proctor 試験で使用する稼働中の Fly.io マシンを一覧表示します。
destroy_machine	machines	書き込み	Fly.io マシンを削除します。
cancel_exam	machines	書き込み	実行中の Proctor 試験をキャンセルします。

ツールグループ

このサーバーでは、ツールをグループに分類し、グループごとに有効または無効にできます。各グループには 2 つのバリアントがあります。

• 基本グループ（例：exams）：読み取りと書き込みのフルアクセス
• 読み取り専用グループ（例：exams_readonly）：読み取り専用アクセス

利用可能なグループ

グループ	ツール	説明
exams	2	試験の実行機能一式（読み取りと書き込み）
exams_readonly	1	試験のメタデータ（読み取り専用）
machines	3	マシン管理機能一式（読み取りと書き込み）
machines_readonly	1	マシンの一覧表示（読み取り専用）

グループ別のツール

• exams / exams_readonly：
  • 読み取り専用：get_proctor_metadata
  • 書き込み：run_exam
• machines / machines_readonly：
  • 読み取り専用：get_machines
  • 書き込み：destroy_machine、cancel_exam

環境変数

変数	説明	デフォルト
PROCTOR_API_KEY	PulseMCP Proctor API の API キー（必須）	-
PROCTOR_API_URL	Proctor API のベース URL	https://admin.pulsemcp.com
TOOL_GROUPS	有効にするツールグループをカンマ区切りで指定します	exams,machines（すべてのグループ）

例

すべてのツールをフルアクセスで有効にする（デフォルト）：

# No TOOL_GROUPS needed - all base groups enabled

試験ツールのみを有効にする：

TOOL_GROUPS=exams

マシンを読み取り専用アクセスで有効にする：

TOOL_GROUPS=machines_readonly

すべてのグループを読み取り専用アクセスで有効にする：

TOOL_GROUPS=exams_readonly,machines_readonly

グループごとにフルアクセスと読み取り専用アクセスを組み合わせる：

# Full exam access, read-only machines
TOOL_GROUPS=exams,machines_readonly

使用上のヒント

• get_proctor_metadata を使用して、利用可能なランタイムと試験の種類を確認します
• run_exam を実行して、ストリーミング形式の進行状況ログで MCP サーバーをテストします
• get_machines を使用して、稼働中の試験インフラを監視します
• 不要になったら destroy_machine を使用してマシンをクリーンアップします
• マシンを破棄する前に、停止した、または遅い試験を cancel_exam で中止します

例

利用可能な試験を取得する

User: What exams can I run with Proctor?
Assistant: I'll check what exams are available.

[Calls get_proctor_metadata]

Here are the available exams:

**Runtimes:**
- Proctor v0.0.37 (id: v0.0.37)

**Exams:**
- Auth Check (id: proctor-mcp-client-auth-check) - Verifies authentication mechanisms
- Init Tools List (id: proctor-mcp-client-init-tools-list) - Tests initialization and tool listing

インフラを監視する

User: What machines are currently running?
Assistant: I'll check the active Fly machines.

[Calls get_machines]

There are 2 active machines:

1. **machine-abc123** - Running in sjc region (created 10 minutes ago)
2. **machine-def456** - Stopped in iad region (created 1 hour ago)

セットアップ

Claude Desktop

Proctor API キーを用意してください。

続いて、以下のセットアップ手順に進んでください。MCP サーバーを初めて使用する場合は、Claude Desktop アプリケーションをインストールし、公式の MCP セットアップ手順に従ってください。

手動セットアップ

ターミナルで npx コマンドを実行できるように、マシンに Node が必要です。Node がインストールされていない場合は、nodejs.orgからインストールできます。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.json ファイルを編集して、以下を追加します。

{
  "mcpServers": {
    "proctor": {
      "command": "npx",
      "args": ["-y", "proctor-mcp-server"],
      "env": {
        "PROCTOR_API_KEY": "your-api-key-here",
        "TOOL_GROUPS": "exams,machines"
      }
    }
  }
}

Claude Desktop を再起動すれば、準備完了です！

読み取り専用アクセスの場合：

{
  "mcpServers": {
    "proctor-readonly": {
      "command": "npx",
      "args": ["-y", "proctor-mcp-server"],
      "env": {
        "PROCTOR_API_KEY": "your-api-key-here",
        "TOOL_GROUPS": "exams_readonly,machines_readonly"
      }
    }
  }
}

開発

クイックセットアップ

# Install dependencies
npm run install-all

# Build the server
npm run build

# Set your API key
export PROCTOR_API_KEY="your-api-key-here"

# Run the server
cd local && npm start

ライセンス

MIT