@supernova123/grpc-mcp-server

MCP server for gRPC — service discovery via server reflection, method invocation, and type schema inspection for AI agents.

Features

• Service Discovery — Automatically discover all gRPC services via server reflection

• Method Invocation — Call any RPC method with JSON-serialized requests

• Health Checking — Standard gRPC Health Checking Protocol support

• Type Inspection — View service descriptors, method signatures, and streaming modes

• Generic — Works with any gRPC endpoint (no proto files required)

Related MCP server: Agorus MCP Server

Tools

Quick Start

npx @supernova123/grpc-mcp-server

Or with environment variables:

GRPC_ENDPOINT=localhost:50051 npx @supernova123/grpc-mcp-server

Environment Variables

Example Usage

1. Connect to a gRPC server:

   connect_endpoint(endpoint="localhost:50051")

2. Discover available services:

   list_services()

3. List methods for a service:

   list_methods(service_name="grpc.health.v1.Health")

4. Invoke an RPC method:

   invoke_rpc(
     service_name="grpc.health.v1.Health",
     method_name="Check",
     request={"service": ""}
   )

Requirements

• Node.js 18+

• Target gRPC server must support gRPC Server Reflection (v1)

License

MIT