proctor

Proctor MCP 服务

还不了解 MCP？想及时了解最新动态，最简单的方式就是阅读我们在 PulseMCP 上发布的每周通讯。

---

这是一个 MCP（Model Context Protocol）服务，用于在 MCP 服务上运行 Proctor 考试。它可通过直接集成 PulseMCP Proctor API，提供执行测试、管理考试基础设施和跟踪测试结果的工具。

注意：这是 PulseMCP 团队的内部工具。源代码公开仅供参考，但该服务需要目前未公开提供的 API 密钥。

目录

• 亮点
• 功能
• 工具组
• 使用提示
• 示例
• 设置
  • 速查表
  • Claude Desktop
    • 手动设置

亮点

考试执行：在 MCP 服务上运行 Proctor 考试，以测试功能和协议合规性。

结果管理：保存和检索考试结果，以便进行比较和回归测试。

基础设施控制：列出、管理和清理用于执行考试的 Fly.io 机器。

工具组：通过 TOOL_GROUPS 环境变量启用或禁用工具组。每个组都有一个基础变体（完全访问权限）和一个 _readonly 变体（只读访问权限）。

流式结果：通过 NDJSON 流式传输实时考试执行日志。

功能

此服务在 macOS 上构建，并使用 Claude Desktop 进行测试。它也应该适用于其他 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 考试。

工具组

此服务将工具划分为多个组，可选择性地启用或禁用。每个组有两个变体：

• 基础组（例如 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 官方设置说明操作。

手动设置

你需要在计算机上安装 Node，以便在终端中运行 npx 命令。如果尚未安装 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