MCP Grpcurl

This project is an Model Context Protocol (MCP) server designed to interact with gRPC services using the grpcurl tool. It leverages the grpcurl command-line utility to perform various operations on gRPC services, such as invoking methods, listing services, and describing service details.

Features

- Invoke gRPC Methods: Use reflection to invoke gRPC methods with custom headers and JSON payloads.
- List gRPC Services: Retrieve a list of all available gRPC services on the target server.
- Describe gRPC Services: Get detailed descriptions of gRPC services or message types.

Requirements

- Go 1.23.0 or later
- grpcurl tool installed on your system

Setup

2. Install the package:

   go install github.com/wricardo/mcp-grpcurl@latest

   

3. Configure Cline by adding the following to your MCP settings:

   "mcp-grpcurl": {

     "command": "mcp-grpcurl",

     "env": {

       "ADDRESS": "localhost:8005"

     },

     "disabled": false,

     "autoApprove": []

   }

   

Usage

Run the MCP server:

mcp-grpc-client

Tools

- invoke: Invoke a gRPC method using reflection.
- Parameters:
- method: Fully-qualified method name (e.g., package.Service/Method).
- request: JSON payload for the request.
- headers: (Optional) JSON object for custom gRPC headers.

- list: List all available gRPC services on the target server.

- describe: Describe a gRPC service or message type.
- Use dot notation for symbols (e.g., mypackage.MyService).