Grpcmcp

MCP Server for gRPC

go

26

GitHub Stars

go

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "adiom-data-grpcmcp": {
      "command": "grpcmcp",
      "args": [
        "--reflect"
      ]
    }
  }
}

You can run grpcmcp as an MCP server that proxies a gRPC backend using either reflection or a protobuf descriptor file. It exposes an MCP transport to connect your MCP client to the gRPC services, enabling you to access and invoke gRPC endpoints through a standardized MCP interface.

How to use

Start a local gRPC backend, then run grpcmcp to connect to it and expose an MCP-compatible transport. You can either rely on server reflection or provide a descriptors file to discover gRPC endpoints. With the SSE transport, you can access the MCP endpoint at a dedicated HTTP path; with the STDIN transport, you can run an explicit command that launches grpcmcp and waits for MCP traffic.

How to install

Prerequisites: install the Go toolchain and ensure your Go bin directory is in your PATH.

Install the grpcmcp binary by building from source or installing the module: this will place the grpcmcp executable in your Go bin directory.

go install .
# or
go install github.com/adiom-data/grpcmcp

Additional notes

Quick start example shows how to start a simple gRPC server and then expose it via MCP transport. The gRPC server runs a health service on port 8090 with server reflection enabled. You can then enable an MCP transport using reflection or a descriptors file.

Standard steps to exercise the server locally include starting the gRPC backend, then launching grpcmcp with either reflection or a descriptor source, as described below.

Available tools

SSE transport

Exposes the MCP API over Server-Sent Events via an HTTP endpoint, enabling clients to subscribe to real-time updates and requests.

STDIN transport

Runs the MCP server as a local process and reads configuration from a JSON object, supporting programmatic startup and management.

Descriptor-based discovery

Uses a protobuf descriptors file to enumerate available gRPC services and methods for MCP clients.

Reflection-based discovery

Queries the backend gRPC server to discover services and methods when a descriptors file is not provided.

Health and reflection support

Starts a health service and enables server reflection to assist MCP clients in discovering endpoints.