MCP Grpcurl logo

MCP Grpcurl

by wricardo

MCP Grpcurl is an MCP server designed to interact with gRPC services using the `grpcurl` tool. It allows you to invoke methods, list services, and describe service details of gRPC services.

View on GitHub

Last updated: N/A

What is MCP Grpcurl?

MCP Grpcurl is a server that acts as an interface between an Model Context Protocol (MCP) environment and gRPC services. It leverages the grpcurl command-line utility to perform operations on gRPC services, such as invoking methods, listing available services, and describing service details.

How to use MCP Grpcurl?

  1. Install Go 1.23.0 or later and grpcurl. 2. Install the package using go install github.com/wricardo/mcp-grpcurl@latest. 3. Configure your MCP settings to include the mcp-grpcurl command and environment variables, particularly the ADDRESS for the gRPC service. 4. Run the MCP server using mcp-grpc-client.

Key features of MCP Grpcurl

  • Invoke gRPC Methods with custom headers and JSON payloads.

  • List available gRPC services on the target server.

  • Describe gRPC services or message types.

  • Uses reflection to interact with gRPC services.

Use cases of MCP Grpcurl

  • Testing gRPC services without writing client code.

  • Exploring the structure and capabilities of gRPC APIs.

  • Automating gRPC service interactions within an MCP environment.

  • Debugging gRPC service issues by directly invoking methods and inspecting responses.

FAQ from MCP Grpcurl

What is grpcurl?

grpcurl is a command-line tool for interacting with gRPC services. It's like curl, but for gRPC.

What is MCP?

MCP stands for Model Context Protocol. It's a framework for managing and interacting with different tools and services.

How do I specify the gRPC service address?

The gRPC service address is specified in the MCP configuration under the ADDRESS environment variable.

What is the 'invoke' tool?

The 'invoke' tool allows you to call a specific gRPC method with a JSON request body and optional headers.

How do I find the available gRPC services?

Use the 'list' tool to retrieve a list of all available gRPC services on the target server.