Loadster MCP

官方

负载测试和合成监控。使用Playwright、浏览器机器人或协议机器人测试您的网站。通过MCP构建和运行测试脚本、配置负载测试、分析测试结果并设置监控。

你可以用 Loadster MCP 做什么？

列出项目并查看文档 — 通过 list_projects 和 get_documentation 查看您的 Loadster 项目或调取 API 文档。
创建和编辑负载测试脚本 — 让助手使用 create_script、validate_script 和 update_script 编写、验证或更新脚本。
管理数据集和场景 — 使用 create_dataset 和 create_scenario 构建或修改测试数据和场景配置。
设置并查看监控 — 使用 create_monitor 和 list_incidents 创建或检查监控和事件的状态。
分析负载测试报告 — 通过 get_load_test_report 和 update_load_test_notes 拉取过往测试结果并添加备注。

文档

Loadster MCP

Loadster 是一个云端负载测试与监控平台。其内置的 Model Context Protocol（MCP）服务器让 Claude、ChatGPT、Codex、 Cursor 和 VS Code 等 AI 代理能够编写和运行负载测试脚本、构建负载测试场景、设置监控器，并在你的 Loadster 账户中分析结果。

本仓库是连接该服务器的公共入口：包含各客户端的配置片段、Claude Code 插件，以及 Loadster 在 MCP 目录中条目背后的元数据。服务器本身由 Loadster 托管于 https://api.loadster.com/mcp，其源代码未在此发布。

完整的最新指南是 Loadster 手册中的 AI 代理章节。本 README 是简版说明。

Loadster MCP 端点


URL	`https://api.loadster.com/mcp`
传输方式	Streamable HTTP
认证	OAuth 2.1（推荐），或在 `Authorization: Bearer` 请求头中使用 MCP 令牌
注册名称	`com.loadster/loadster-mcp`

OAuth 是最简单的连接方式。支持 MCP OAuth 的客户端会将你引导至 Loadster，在浏览器中批准连接，你可以在 Loadster 设置中的 AI Agents 页面查看或撤销已连接的代理。

MCP 令牌 适用于不支持 OAuth 的客户端，以及 CI 任务和脚本化代理。请在 Loadster 控制台的 Settings → AI Agents → MCP Tokens 下创建令牌，立即复制（仅显示一次），并将其作为 Authorization: Bearer YOUR_TOKEN 发送。令牌代表你在创建它的团队内执行操作，因此请像对待密码一样妥善保管。

将 Claude Code 连接到 Loadster

最快的方式是使用本仓库中的插件，它会添加 Loadster MCP 服务器以及一些编码了合理负载测试工作流的技能：

/plugin marketplace add loadster/loadster-mcp
/plugin install loadster@loadster

然后运行 /mcp，选择 loadster，并在浏览器中批准 OAuth 连接。尝试让 Claude 执行类似 "列出我的 Loadster 项目" 的操作，以确认它能访问你的账户。

不使用插件时，可直接添加服务器，Claude Code 会引导你完成 OAuth：

claude mcp add --transport http loadster https://api.loadster.com/mcp

或者使用 MCP 令牌进行无头使用：

claude mcp add --transport http loadster https://api.loadster.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

等效的项目级 .mcp.json：

{
  "mcpServers": {
    "loadster": {
      "type": "http",
      "url": "https://api.loadster.com/mcp"
    }
  }
}

将 Claude Desktop 和 claude.ai 连接到 Loadster

Claude Desktop 和 claude.ai 通过自定义连接器连接远程 MCP 服务器，这些连接器使用 OAuth。

打开 Settings → Connectors，选择 Add custom connector。
输入名称和 URL https://api.loadster.com/mcp。
选择 Connect，并在浏览器打开时批准 Loadster OAuth 连接。
在对话中，打开工具菜单并启用 Loadster 连接器。

将 ChatGPT 和 Codex 连接到 Loadster

网页版 ChatGPT 通过 Developer mode（Settings → Security and login）中创建的插件进行连接。打开 Plugins，添加一个使用 URL https://api.loadster.com/mcp 的连接，然后从工具菜单将其添加到新对话中，并批准 OAuth 连接。

ChatGPT 桌面应用中的 Codex、Codex CLI 和 Codex IDE 扩展共享同一配置：

codex mcp add loadster --url https://api.loadster.com/mcp
codex mcp login loadster

或者使用 ~/.codex/config.toml 中的 MCP 令牌：

[mcp_servers.loadster]
url = "https://api.loadster.com/mcp"
bearer_token_env_var = "LOADSTER_MCP_TOKEN"

将 Cursor 连接到 Loadster

或者将其添加到项目中的 .cursor/mcp.json（或所有项目的 ~/.cursor/mcp.json），并在 Cursor 首次连接时批准 OAuth 连接：

{
  "mcpServers": {
    "loadster": {
      "url": "https://api.loadster.com/mcp"
    }
  }
}

如需改用 MCP 令牌，请在启动 Cursor 前添加 "headers": { "Authorization": "Bearer ${env:LOADSTER_MCP_TOKEN}" }，并在环境中设置 LOADSTER_MCP_TOKEN。

将 VS Code 连接到 Loadster

或者从命令面板运行 MCP: Add Server，或将其添加到 .vscode/mcp.json：

{
  "servers": {
    "loadster": {
      "type": "http",
      "url": "https://api.loadster.com/mcp"
    }
  }
}

如需使用 MCP 令牌，请声明一个带有 "password": true 的 promptString 输入，并在 Authorization 请求头中引用它。手册中有完整示例。

将其他 MCP 客户端连接到 Loadster

任何支持通过 Streamable HTTP 连接远程服务器的客户端都可以用相同方式连接。对于仅支持本地（stdio）服务器的客户端，mcp-remote 桥接通常可以解决问题。省略 --header 参数，让它运行 OAuth 流程而不是使用令牌：

{
  "mcpServers": {
    "loadster": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.loadster.com/mcp", "--header", "Authorization: Bearer YOUR_TOKEN"]
    }
  }
}

代理可以用 Loadster 做什么

服务器暴露了 Loadster 控制台的大部分功能。客户端在连接时会获取实时工具列表，因此下表只是功能概览，而非权威来源。

分组	工具
项目与文档	`list_projects`, `get_documentation`, `get_scripting_api`, `get_example`, `list_command_types`, `get_command_schema`, `get_variable_schema`
脚本	`list_scripts`, `get_script`, `create_script`, `update_script`, `duplicate_script`, `delete_script`, `import_script`, `validate_script`, `play_script`, `get_play_status`, `stop_script`, `get_step_detail`, `get_screenshot`, `list_script_revisions`, `get_script_revision`, `restore_script_revision`, `list_script_assets`, `get_script_asset`, `put_script_asset`, `delete_script_asset`
数据集	`list_datasets`, `get_dataset`, `create_dataset`, `update_dataset`, `append_dataset_rows`, `delete_dataset`
场景与引擎	`list_scenarios`, `get_scenario`, `create_scenario`, `update_scenario`, `delete_scenario`, `list_engines`
负载测试报告	`list_load_tests`, `get_load_test_report`, `update_load_test_notes`
监控	`list_monitoring_locations`, `list_monitors`, `get_monitor`, `create_monitor`, `update_monitor`, `disable_monitor`, `delete_monitor`, `list_monitor_cycles`, `get_monitor_cycle_detail`, `get_monitoring_summary`, `list_incidents`, `get_incident`
反馈	`submit_feedback`

某些操作有意保留给人类。代理无法启动或停止完整的负载测试、启用监控器、管理通知策略或维护窗口，也无法管理你的团队、计费或 Fuel。它会准备好一切并移交给你，由你按下启动按钮。

每个工具都带有 MCP 注解（readOnlyHint, destructiveHint, idempotentHint, openWorldHint），因此支持这些注解的客户端可以在写入和删除前进行提示。

AI 负载测试的安全实践

代理在你的账户中操作。 它会编辑你的团队可见的脚本、场景、数据集和监控器。脚本更改会创建可恢复的修订版本，但最好还是审查提议的更改，并将实验放在独立项目中。
只测试属于你的系统。 只将脚本指向你拥有或有权测试的系统。运行脚本会启动单个机器人，但无论如何这都是你的责任。
限制访问范围。 每个代理或机器使用一个令牌，清晰命名，并撤销不再使用的令牌。在 AI Agents 页面审查 OAuth 连接。

支持

设置帮助与问题：help@loadster.com
安全问题：参见 SECURITY.md
本仓库内容（README、插件或目录元数据）的问题：在此处提交 issue

仓库内容

路径	用途
`server.json`	Loadster 在官方 MCP 注册表中的条目
`glama.json`	Glama 列表的维护者元数据
`.claude-plugin/`, `.mcp.json`, `skills/`	Claude Code 插件及其市场清单
`.github/workflows/`	每次推送时的验证，以及发布时的注册表发布

许可证

本仓库内容根据 MIT 许可证发布。Loadster 服务本身受 Loadster 服务条款约束。