artillery-mcp
Artillery 2.x load-testing via MCP — one-command install for @kosiakmd/artillery-mcp. Ships a stdio MCP server with 18 tools (run_test_from_
Open source Repository Open in the app JSON README (API)
About
Artillery 2.x load-testing via MCP — one-command install for @kosiakmd/artillery-mcp. Ships a stdio MCP server with 18 tools (run_test_from_file, run_fargate, read_artillery_output, parse_results, run_report, compare_results, etc.) plus an agent SKILL.md with decision tree, call patterns, and gotchas. Config-driven: drop an .artillery-mcp.config.json at your project root and a 19th run_project_lt tool appears for one-liner flow×environment launches. Uses the published @kosiakmd/artillery-mcp npm package via npx caret-minor pin (patch fixes flow through automatically). MIT, open source, multi-arch Docker image also available. Prerequisites: Node 20+, artillery CLI on PATH.
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- kosiakmd
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-04-21T17:10:39Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
kosiakmd/artillery-mcp-plugin/artillery-mcp
README
# artillery-mcp-plugin
Claude Code plugin for [`@kosiakmd/artillery-mcp`](https://github.com/kosiakMD/artillery-mcp) — Artillery 2.x load-testing via MCP. Installs the MCP server + agent skill in one command, no manual `claude mcp add`.
## What's in the box
- **MCP server:** `@kosiakmd/artillery-mcp` (stdio, via `npx` — no global install required)
- **Agent skill:** `SKILL.md` with decision tree / tool call patterns / common gotchas, auto-loaded by Claude Code when the plugin is enabled
## Install
In a Claude Code session:
```
/plugin marketplace add kosiakMD/artillery-mcp-plugin
/plugin install artillery-mcp@artillery-mcp
```
Restart your session. You now have 18 MCP tools (19 if the target project has `.artillery-mcp.config.json` for the opt-in project launcher).
## Prerequisites
- **Artillery CLI** on `PATH` — `npm install -g artillery@latest`. The MCP wraps it; the npm package doesn't bundle the binary.
- **Node.js ≥ 20**
- **`ARTILLERY_CLOUD_API_KEY`** — only if you want to record runs to Artillery Cloud. Export it in your shell before launching Claude Code, or load via a dotenv wrapper; see the [MCP README § Security](https://github.com/kosiakMD/artillery-mcp#security).
Prefer Docker (no host Node/Artillery)? Skip this plugin — use the Docker variant directly as documented in the [MCP README § Docker](https://github.com/kosiakMD/artillery-mcp#docker).
## What you can do after install
```
You: "Run a quick HTTP test against https://api.example.com at 50 req/s for 30 seconds"
Claude: [calls mcp__artillery-mcp__quick_test → returns summary]
You: "Parse results.json and show me the latency breakdown"
Claude: [calls mcp__artillery-mcp__parse_results → formatted p50/p95/p99]
You: "Compare baseline.json vs yesterday.json — did anything regress?"
Claude: [calls mcp__artillery-mcp__compare_results → diff with thresholds]
```
Full tool reference: [MCP README § tools](https://github.com/kosiakMD/artillery-mcp#18-base-tools-no-config-needed).
## Optional — project launcher
If your project uses multiple named flows (e.g. `free`, `paid`, `combined` for different checkout variants), add `.artillery-mcp.config.json` at the repo root:
```json
{
"flows": { "smoke": "tests/load/smoke.yml" },
"environments": ["local", "staging", "prod"],
"defaultTags": { "repo": "my-app" },
"tagTemplates": ["type:{flow}", "env:{env}"],
"outputDir": "load-test-results"
}
```
Then `run_project_lt` appears as a 19th tool:
```
You: "Run smoke on staging, note 'canary v42'"
Claude: [calls run_project_lt(flow="smoke", environment="staging", note="canary v42")]
```
Full config schema: [MCP README § Full config reference](https://github.com/kosiakMD/artillery-mcp#full-config-reference). To scaffold: `npx @kosiakmd/artillery-mcp init` in your project.
## Versioning
| Component | Version | Where pinned |
|---|---|---|
| Plugin | `0.1.0` | `.claude-plugin/marketplace.json` + `plugins/artillery-mcp/.claude-plugin/plugin.json` |
| MCP server | `^0.1` (resolves to latest `0.1.x`) | `plugins/artillery-mcp/.claude-plugin/plugin.json` → `mcpServers.artillery-mcp.args` |
Plugin bumps happen for skill content / manifest changes. MCP bumps are independent and auto-picked via caret-minor.
## See also
- [**MCP server source**](https://github.com/kosiakMD/artillery-mcp) — runtime code, `run_report`, `run_fargate`, config loader, tests
- [**npm package**](https://www.npmjs.com/package/@kosiakmd/artillery-mcp) — `@kosiakmd/artillery-mcp`
- [**Docker image**](https://hub.docker.com/r/kosiakmd/artillery-mcp) — `kosiakmd/artillery-mcp:latest`
- [**MCP Official Registry entry**](https://registry.modelcontextprotocol.io/) — `io.github.kosiakMD/artillery-mcp`
## License
MIT. See [LICENSE](./LICENSE).