goku

Goku is a high-performance HTTP load-testing tool that now exposes its capabilities via the Model Context Protocol (MCP). When registered as an MCP tool, you can invoke Goku programmatically from an LLM agent or any MCP-aware client to run load tests against a target URL and retrieve structured performance metrics (e.g., requests, concurrency, and latency percentiles) without manual CLI interactions. This enables integrating Goku’s benchmarking capabilities into automated workflows, AI agent orchestration, and larger toolchains.

To use Goku via MCP, first ensure the MCP-enabled Goku server is installed and running. Then you can issue MCP tool calls to start a test, specify parameters such as target URL, number of clients, iterations, duration, and optional headers or request body. Goku will execute the test and return results including key metrics like total requests, time taken, and percentile latency measurements. This makes it straightforward to embed performance testing inside agents that can reason about when and how to benchmark a service, compare results over time, or drive CI/CD pipelines with automated load tests.

Prerequisites:

• Rust toolchain installed (rustup, cargo)
• Internet access to fetch crates

Step-by-step installation:

1. Install Rust and Cargo (if not already installed)
   • On Unix-like systems: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   • Follow prompts to install and enable cargo in your PATH.
2. Install Goku MCP server via Cargo
   • Run: cargo install goku-mcp
3. Verify installation
   • Run: goku-mcp --help # or check version if available
4. Start the MCP server (if your environment requires explicit startup commands, refer to your MCP setup)
   • The MCP-enabled binary will be available after installation and can be invoked by your MCP framework as configured.

Optional: If you prefer automatic download scripts mentioned in the project README, you can use:

• For MCP: curl -sSL https://raw.githubusercontent.com/jcaromiq/goku/v2.0.1/scripts/install_mcp.sh | sh

Prerequisites recap:

• Rust toolchain (rustup/cargo) or prebuilt binaries
• Network access to fetch crates or run the provided install script
• Basic familiarity with MCP tooling to register and call the Goku MCP endpoint

Notes and tips:

• If you plan to run high-concurrency tests, consider system-level tuning (e.g., file descriptor limits, network stack caches) to avoid artificial bottlenecks.
• When using MCP, you can parameterize tests with target URL, clients, iterations, duration, and optional headers or a YAML/JSON scenario file if supported by your MCP integration.
• Ensure you expose the Goku MCP endpoint securely if used in multi-tenant or public environments.
• The MCP integration enables running tests from within agents or scripts, so you can automate benchmarking as part of workflows (e.g., CI pipelines, automated R&D experiments).
• If you encounter installation issues, check Rust toolchain version compatibility and ensure the cargo install path is in your system PATH.