grpcurl-mcp

grpcurl-mcp

3.4

If you are the rightful owner of grpcurl-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP Grpcurl is a Model Context Protocol server designed to interact with gRPC services using the grpcurl tool.

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

  1. install grpcurl: https://github.com/fullstorydev/grpcurl

  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).