GRPC

Provides a Node.js MCP server to load proto definitions, inspect methods, and perform unary gRPC requests.

typescript

1

GitHub Stars

typescript

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": {
    "yuki4-dev-grpc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "grpc-mcp"
      ]
    }
  }
}

grpc-mcp is an MCP server built with Node.js and TypeScript. It enables you to retrieve service and method information from Protocol Buffer files and to send unary gRPC requests with options like SSL, timeouts, and headers, making it easier to explore and test gRPC services from MCP clients or VSCode extensions.

How to use

You can interact with grpc-mcp from an MCP client to load proto definitions, inspect method signatures, and send unary gRPC requests. Start by loading your proto files to discover available services and methods, then request method information to learn the expected request and response shapes, and finally send a unary request to a running gRPC server to see the response and timing.

How to install

Prerequisites: ensure Node.js and npm are installed on your system. You can verify installations with the following commands.

node -v
npm -v

Install dependencies and build the project, then start the server using the runtime command shown in the usage examples.

npm install
npm run build

# Start the server using the example path from the usage snippet
node C:~\node_modules\grpc-mcp\dist\index.js

Configuration and usage notes

You can run grpc-mcp in a local, stdio-based setup where the MCP client launches the server process and communicates over standard I/O.

If you prefer to start the MCP server via an MCP client, you can use one of the following starter configurations.

{
  "servers": {
    "grpc-mcp-sample": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "grpc-mcp"]
    }
  }
}

Additional notes on unary RPCs and limitations

grpc-mcp supports only unary (single-request, single-response) gRPC calls. It does not support streaming RPCs, including server streaming, client streaming, or bidirectional streaming.

Examples of common operations

Load proto files from a directory to discover available services and methods, then request detailed method information, and finally send a gRPC request with your desired payload and options.

Available tools

loadProto

Load the directory containing proto files to retrieve service and method information.

getMethodInformation

Retrieve request and response structure for a specified service and method.

sendRequest

Send a unary gRPC request with a proto path, target address, service, method, and request body, with optional SSL and timeout settings.