Loadster MCP

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 也是 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 页面中查看或撤销已连接的代理。

个人访问令牌适用于无法使用 OAuth 的客户端，以及 CI 任务和脚本化代理。同类型的 令牌也可用于直接调用 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"
    }
  }
}

要使用个人访问令牌，请声明一个带有 "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 仪表板的大部分功能。客户端在连接时获取实时工具列表，因此此表 是功能面的地图，而非事实来源。Loadster 手册中的 MCP 工具参考 由工具定义本身生成，包含每个工具的参数以及它是 Read、Write 还是 Sensitive write。

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

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

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

AI 负载测试的安全实践

• 代理在你的账户中行事。 它编辑的脚本、场景、数据集和监控与你的团队看到的是同一批。 脚本更改会创建可恢复的修订，但审查提议的更改并将 实验保留在各自的项目中仍然是个好主意。
• 只测试属于你的系统。 仅将脚本指向你拥有或获授权测试的系统。播放脚本会运行 单个机器人，但无论如何这都是你的责任。
• 限定你的访问范围。 为每个代理或机器使用一个令牌，清晰命名，并撤销不再使用的令牌。 如果代理只需要读取，在批准 OAuth 连接时选择 Read only 而非 Full access （mcp:read 范围），或在创建令牌时勾选 Read only。这样它只能使用 读取类工具，无法更改任何内容或播放脚本。在 Loadster 设置的 API & MCP 页面查看 OAuth 连接。 参见 你的助手如何认证。

支持

• 设置帮助和问题：help@loadster.com
• 安全问题：参见 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 服务条款约束。