grpcurlとは何ですか？

gRPCサーバーに対してcurlのようにコマンドラインからリクエストを送れるツール。サーバーリフレクションを使ってAPIの定義を動的に取得し、手軽にテストできる。

grpcurlのポイントは？

コマンドラインからgRPCサーバーにリクエストを送信できる。サーバーリフレクションで.protoファイルなしでもAPI定義を取得できる。JSON形式でリクエスト・レスポンスを扱えるので読みやすい。ストリーミングRPCにも対応している

【ジーアールピーシーカール】

公開: 2026年3月29日

💡 gRPCの世界にcurlの手軽さを持ち込むツール

📌 このページのポイント

grpcurl のリクエストフローのイメージ

ひよこ

gRPCのAPIをテストしたいけど、curlだとバイナリプロトコルだから使えないんだよね…

ペンギン先生

grpcurlを使えばcurlみたいな手軽さでgRPC サーバーにリクエストを送れるよ。JSONでリクエストを書いて、レスポンスもJSONで返ってくるんだ

ひよこ

.protoファイルが必要なの？

ペンギン先生

サーバーがリフレクションを有効にしてれば.protoファイルなしでもOKだよ。`grpcurl localhost:50051 list`でサービス一覧、`describe`でメソッドの詳細が見えるんだ

ひよこ

実際のリクエストはどう書くの？

ペンギン先生

`grpcurl -d '{"name": "world"}' localhost:50051 greeter.Greeter/SayHello`みたいに書くよ。-dオプションでJSONのリクエストボディを指定するんだ

ひよこ

ストリーミングのRPCもテストできる？

ペンギン先生

サーバーストリーミングもクライアントストリーミングも対応してるよ。双方向ストリーミングのテストもできるから、gRPCの全機能をコマンドラインから試せるんだ

ひよこ

CIでの自動テストにも使える？

ペンギン先生

もちろん。gRPC サーバーのヘルスチェックや簡易的なE2Eテストをシェルスクリプトで書けるよ。jqと組み合わせてレスポンスの検証もできるから、CI/CDパイプラインにも組み込みやすいんだ

まとめ：ざっくりこれだけ覚えればOK！

「grpcurl」って出てきたら「gRPC版のcurl、コマンドラインでgRPCを叩けるツール」と思えればだいたいOK！

📖 おまけ：英語の意味

「gRPC + curl」＝ gRPC版のcurl

💬 curlがHTTPリクエストを送るツールなら、grpcurlはgRPCリクエストを送るツール。名前もそのままだよ