MCP Grpcurl

Name: MCP Grpcurl
Author: wricardo

@wricardo

代码仓库

关于 MCP Grpcurl

Model Context Protocol (MCP) server to interact with gRPC services using the grpcurl tool

#grpcurl #grpc #mcp

基本信息

分类

其他

运行时

传输方式

stdio

发布者

wricardo

配置

暂无标准配置

该服务器的 README 中没有可解析的 MCP 配置块，请前往代码仓库查看安装说明。

代码仓库

工具

Invoke a gRPC method using reflection.

List all available gRPC services on the target server.

Describe a gRPC service or message type.

概览

What is MCP Grpcurl?

MCP Grpcurl is a Model Context Protocol (MCP) server that interacts with gRPC services using the grpcurl command-line utility. It enables listing services, describing service details, and invoking gRPC methods via reflection. It is intended for developers and AI agents that need to call or inspect gRPC endpoints programmatically.

How to use MCP Grpcurl?

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.

Key features of MCP Grpcurl

Invoke gRPC methods with custom headers and JSON payloads.
List all available gRPC services on the target server.
Describe gRPC services or message types using reflection.
Lightweight, leverages the well-known grpcurl tool.
Integrates seamlessly with any MCP‑compatible client.

Use cases of MCP Grpcurl

Allow an AI assistant to call a specific gRPC method and receive a response.
Explore all available gRPC services on a development server for debugging.
Describe the structure of a gRPC service or message type without manual inspection.
Automate testing of gRPC endpoints from an MCP‑enabled workflow.

FAQ from MCP Grpcurl

What are the requirements for MCP Grpcurl?

Go 1.23.0 or later and the grpcurl command-line tool installed on your system.

How do I install MCP Grpcurl?

Install grpcurl first (from fullstorydev/grpcurl), then run go install github.com/wricardo/mcp-grpcurl@latest. Configure your MCP client with the command mcp-grpcurl and set the ADDRESS environment variable to your gRPC server’s address.

What tools does MCP Grpcurl provide?

It provides three tools: invoke (call a gRPC method with an optional JSON request and custom headers), list (list all available services), and describe (describe a service or message type using dot notation).

How do I specify the target gRPC server?

Set the environment variable ADDRESS in the MCP server configuration (e.g., "ADDRESS": "localhost:8005"). The server connects to that address for all operations.