gRPC Swagger vs grpcmd

gRPC Swagger is a free, open-source debugging tool for discovering and calling gRPC methods through Swagger UI. It uses server reflection to scan a registered endpoint, identified by host and port, and then displays available services, method definitions, and parameters. Users can invoke methods with Swagger UI’s “Try it out” control, supplying request data and headers as JSON; the headers are passed to the gRPC server as metadata. Reflection must be enabled on the gRPC service, but the setup instructions say proto files and related implementations do not need modification. The project runs from a released JAR or from source and defaults to port 8080. Configuration can show registered services and expire inactive registrations after a chosen number of seconds. Documented endpoints cover registration, service listing, method calls, and Swagger documentation. It is self-hosted, available for API and web use, and licensed under MIT.

grpcmd is a free command-line tool for working with gRPC services on Linux, macOS, and Windows. It can use reflection to find available services and methods, describe a method’s request and response messages, and make calls. Requests and responses can stream, with headers, data, and trailers included in output. Users who do not want to rely on reflection can instead provide.proto files and import search paths. The tool can also start a gRPC server implementing grpcmd.GrpcmdService with reflection, and its documentation covers shell completion for Bash, Zsh, fish, and PowerShell. A related tool, grpcmd-script, lets users define endpoint tests in JavaScript and assert response headers, data messages, and trailers; it is distributed as a binary and does not require Node.js. The separate grpcmd-gui desktop app supports reflection-based method lookup, request headers, response headers and trailers, JSON request templates, streaming, and themes. GUI downloads are available for macOS, Windows, and Linux, including amd64 and arm64 builds. grpcmd is listed at free; grpcmd-script is listed at $9 a year with early-bird pricing.