Grpcurl MCP

🚀 MCP Grpcurl Project

This project is a Model Context Protocol (MCP) server designed to interact with gRPC services through 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.

🚀 Quick Start

This MCP Grpcurl project allows you to interact with gRPC services using the grpcurl tool.

✨ Features

• Invoke gRPC Methods: Utilize reflection to call gRPC methods, supporting custom headers and JSON request bodies.
• List gRPC Services: Obtain a list of all available gRPC services on the target server.
• Describe gRPC Services: Get detailed descriptions of specified gRPC services or message types.

📦 Installation

Prerequisites

• Go 1.23.0 or higher
• The grpcurl tool installed on your system

Steps

1. Install grpcurl: Visit GitHub repository and follow the instructions for installation.
2. Install the MCP Grpcurl package:

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

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

   "mcp-grpcurl": {
     "command": "mcp-grpcurl",
     "env": {
       "ADDRESS": "localhost:8005"
     },
     "disabled": false,
     "autoApprove": []
   }
   

💻 Usage Examples

Basic Usage

Run the MCP server:

mcp-grpc-client

Tool Descriptions

• invoke: Call a specified gRPC method using reflection.
  • Parameters:
    • method: The fully - qualified method name (e.g., package.Service/Method).
    • request: JSON - formatted data for the method request.
    • headers: An optional JSON object for passing custom gRPC headers.
• list: List all available gRPC services on the target server.
• describe: Describe a specified gRPC service or message type. Supports dot - notation (e.g., mypackage.MyService).