MCP Grpcurl

@wricardo

Repository

About MCP Grpcurl

Model Context Protocol (MCP) server to interact with gRPC services using the grpcurl tool

#grpcurl #grpc #mcp

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tools

Invoke a gRPC method using reflection.

List all available gRPC services on the target server.

Describe a gRPC service or message type.

Overview

What is MCP Grpcurl?

MCP Grpcurl is a Model Context Protocol (MCP) server that interacts with gRPC services using the grpcurl command-line utility. It enables listing services, describing service details, and invoking gRPC methods via reflection. It is intended for developers and AI agents that need to call or inspect gRPC endpoints programmatically.

How to use MCP Grpcurl?

Install the grpcurl tool, then run go install github.com/wricardo/mcp-grpcurl@latest. Configure your MCP client (e.g., Cline) with the command mcp-grpcurl and set the environment variable ADDRESS to the target gRPC server address (e.g., localhost:8005). Start the server with mcp-grpcurl. Use the provided tools (invoke, list, describe) to interact with gRPC services.

Key features of MCP Grpcurl

Invoke gRPC methods with custom headers and JSON payloads.
List all available gRPC services on the target server.
Describe gRPC services or message types using reflection.
Lightweight, leverages the well-known grpcurl tool.
Integrates seamlessly with any MCP‑compatible client.

Use cases of MCP Grpcurl

Allow an AI assistant to call a specific gRPC method and receive a response.
Explore all available gRPC services on a development server for debugging.
Describe the structure of a gRPC service or message type without manual inspection.
Automate testing of gRPC endpoints from an MCP‑enabled workflow.

FAQ from MCP Grpcurl

What are the requirements for MCP Grpcurl?

Go 1.23.0 or later and the grpcurl command-line tool installed on your system.

How do I install MCP Grpcurl?

Install grpcurl first (from fullstorydev/grpcurl), then run go install github.com/wricardo/mcp-grpcurl@latest. Configure your MCP client with the command mcp-grpcurl and set the ADDRESS environment variable to your gRPC server’s address.

What tools does MCP Grpcurl provide?

It provides three tools: invoke (call a gRPC method with an optional JSON request and custom headers), list (list all available services), and describe (describe a service or message type using dot notation).

How do I specify the target gRPC server?

Set the environment variable ADDRESS in the MCP server configuration (e.g., "ADDRESS": "localhost:8005"). The server connects to that address for all operations.

Frequently asked questions

What are the requirements for MCP Grpcurl?

Go 1.23.0 or later and the `grpcurl` command-line tool installed on your system.

How do I install MCP Grpcurl?

Install `grpcurl` first (from [fullstorydev/grpcurl](https://github.com/fullstorydev/grpcurl)), then run `go install github.com/wricardo/mcp-grpcurl@latest`. Configure your MCP client with the command `mcp-grpcurl` and set the `ADDRESS` environment variable to your gRPC server’s address.

What tools does MCP Grpcurl provide?

It provides three tools: `invoke` (call a gRPC method with an optional JSON request and custom headers), `list` (list all available services), and `describe` (describe a service or message type using dot notation).

How do I specify the target gRPC server?

Set the environment variable `ADDRESS` in the MCP server configuration (e.g., `"ADDRESS": "localhost:8005"`). The server connects to that address for all operations.