MCP ExplorerExplorer

Grpcurl Mcp

@wricardoon 10 months ago
8 MIT
FreeCommunity
AI Systems
Model Context Protocol (MCP) server to interact with gRPC services using the grpcurl tool

Overview

What is Grpcurl Mcp

grpcurl-mcp is a Model Context Protocol (MCP) server that facilitates interaction with gRPC services using the grpcurl command-line tool.

Use cases

Use cases for grpcurl-mcp include testing gRPC services, debugging service interactions, and exploring available methods and services in a gRPC environment.

How to use

To use grpcurl-mcp, install the grpcurl tool, then install the grpcurl-mcp package using Go. Configure your MCP settings to include the grpcurl command, and run the MCP server using ‘mcp-grpc-client’.

Key features

Key features include invoking gRPC methods with custom headers and JSON payloads, listing all available gRPC services on the target server, and providing detailed descriptions of gRPC services or message types.

Where to use

grpcurl-mcp can be used in various fields such as microservices architecture, API testing, and service discovery in cloud-native applications.

Content

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:

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

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers