Loadster

Loadster MCP

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

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

持续维护的完整指南位于 Loadster 手册的 AI 助手与 MCP 章节。 本 README 是简要版本。

Loadster MCP 端点

URL	https://api.loadster.com/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.1（首选），或在 Authorization: Bearer 标头中使用个人访问令牌
注册表名称	com.loadster/loadster-mcp

OAuth 是最简单的连接方式。支持 MCP OAuth 的客户端会将你带到 Loadster，通过浏览器批准 连接；你可以在 Loadster 设置中的 API & MCP 页面查看或撤销已连接的 Agent。

个人访问令牌适用于不支持 OAuth 的客户端，以及 CI 任务和脚本化 Agent。同类 令牌也可用于直接调用 Loadster REST API。在 Loadster 控制面板的 Settings → API & MCP → Personal Access Tokens 下创建令牌，并立即复制（它只会显示 一次），然后将其作为 Authorization: Bearer YOUR_TOKEN 发送。令牌在创建它的团队中会以你的身份操作，因此 请像对待密码一样保管它。

将 Claude Code 连接到 Loadster

最快的方式是使用此仓库中的插件，它会添加 Loadster MCP 服务，以及一套适用于 负载测试工作流的技能：setup 用于连接，setup-script 用于创建第一个脚本，setup-scenario 用于创建第一个负载测试场景，setup-monitor 用于创建第一个合成监控器，load-test 用于执行完整测试，而 results 用于查看测试结果。

/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

或者，使用个人访问令牌进行无头操作：

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。

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

将 ChatGPT 和 Codex 连接到 Loadster

Loadster 是 ChatGPT 和 Codex 插件目录中的官方插件，包含 setup、load-test 和 results 技能。目录列表更新后，新的 setup-script、setup-scenario 和 setup-monitor 技能也会提供支持。

• **ChatGPT：**打开 Loadster 插件， 选择 Install plugin，然后选择 Connect 并批准 Loadster OAuth 连接。开始与 @Loadster 对话。 在 Business 或 Enterprise 工作区中，管理员可能需要先在 Workspace settings → Plugins 下启用该插件。
• **Codex：**从 Codex 桌面应用的 Plugins 选项卡安装 Loadster，或在 Codex CLI 中运行 /plugins， 然后启动新会话。

Codex IDE 扩展不支持插件，因此需通过 Codex 的 MCP 配置连接；该配置由桌面应用和 CLI 共用：

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

也可以在 ~/.codex/config.toml 中使用个人访问令牌：

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

如果你的 ChatGPT 账户无法使用该插件，仍可在开发者模式（Settings → Security and login）中将 Loadster 添加为自定义连接。打开 Plugins，使用 URL https://api.loadster.com/mcp 添加连接，然后从工具菜单将其添加到新对话，并批准 OAuth 连接。

将 Cursor 连接到 Loadster

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

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

若要改用个人访问令牌，请添加 "headers": { "Authorization": "Bearer ${env:LOADSTER_MCP_TOKEN}" }，并在启动 Cursor 前设置 LOADSTER_MCP_TOKEN 环境变量。

将 VS Code 连接到 Loadster

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

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

若要使用个人访问令牌，请声明一个 promptString 输入，并设置 "password": true，然后在 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"]
    }
  }
}

Agent 可以使用 Loadster 完成哪些操作

该服务公开了 Loadster 控制面板的大部分功能。客户端在连接时会获取实时工具列表，因此此表展示的是功能概览，而非事实来源。Loadster 手册中的 MCP 工具参考 直接根据工具定义生成，其中列出了每个工具的参数，以及它属于读取、写入还是敏感写入操作。

分组	工具
项目和文档	list_projects、create_project、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

有些操作特意留给人工处理。Agent 无法启动或停止完整的负载测试、启用监控、管理通知策略或维护窗口，也无法管理你的团队、账单或 Fuel。它会做好所有准备，然后交由你按下启动按钮。

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

AI 负载测试安全实践

• Agent 会在你的账户中操作。 它会编辑你的团队可见的相同脚本、场景、数据集和监控项。脚本更改会创建可供你恢复的版本，但仍建议你检查拟议的更改，并在单独的项目中进行实验。
• 只测试属于你的系统。 脚本只能指向你拥有或获准测试的系统。运行脚本时只会启动一个机器人，但无论如何，责任都由你承担。
• 限制访问范围。 每个 Agent 或机器使用一个令牌，为令牌设置清晰的名称，并撤销不再使用的令牌。如果 Agent 只需读取数据，请在批准 OAuth 连接时选择 只读，而非 完全访问（mcp:read 范围），或者在创建令牌时勾选 只读。这样它就只能使用读取工具，无法更改任何内容或运行脚本。请在 Loadster 设置的 API 和 MCP 页面检查 OAuth 连接。请参阅助手如何进行身份验证。

支持

• 设置帮助和问题： [email protected]
• 安全问题：请参阅 SECURITY.md
• 关于此仓库内容（README、插件或目录元数据）的问题：请在此处提交 issue

此仓库包含的内容

路径	用途
server.json	Loadster 在官方 MCP 注册表中的条目
glama.json	Glama 列表的维护者元数据
.claude-plugin/、.mcp.json、skills/	Claude Code 插件、其市场清单，以及 setup、setup-script、setup-scenario、setup-monitor、load-test 和 results 技能
.github/workflows/	每次推送时进行验证，并在发布时推送到注册表

许可证

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