MCP Grpcurl
About
Model Context Protocol (MCP) server to interact with gRPC services using the grpcurl tool
Explore
- 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.
Install the grpcurl tool, then run go install github.com/wricardo/mcp-grpcurl@latest. Configure your MCP client (e.g., Cline) with the command mcp-grpcurl and set the environment variable ADDRESS to the target gRPC server address (e.g., localhost:8005). Start the server with mcp-grpcurl. Use the provided tools (invoke, list, describe) to interact with gRPC services.
method
Fully-qualified method name (e.g., `package.Service/Method`).
request
JSON payload for the request.
headers
(Optional) JSON object for custom gRPC headers.
- 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).
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/grpcurl2. Install the package:
go install github.com/wricardo/mcp-grpcurl@latest
3. Configure Cline by adding the following to your MCP settings:
"mcp-grpcurl": {
"command": "mcp-grpcurl",
"env": {
"ADDRESS": "localhost:8005"
},
"disabled": false,
"autoApprove": []
}
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).
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
