Grpcurl MCP

🚀 MCP Grpcurl 项目

本项目是一个 Model Context Protocol (MCP) 服务器，旨在借助 grpcurl 工具与 gRPC 服务进行交互。通过 grpcurl 命令行工具，可对 gRPC 服务执行多种操作，如调用方法、列出服务以及描述服务详细信息。

🚀 快速开始

运行 MCP 服务器：

mcp-grpc-client

✨ 主要特性

• 调用 gRPC 方法：利用反射机制调用 gRPC 方法，并支持自定义头和 JSON 请求体。
• 列举 gRPC 服务：获取目标服务器上所有可用的 gRPC 服务列表。
• 描述 gRPC 服务：获得指定 gRPC 服务或消息类型的详细描述。

📦 安装指南

先决条件

• Go 1.23.0 或更高版本
• 系统上已安装 grpcurl 工具

安装步骤

1. 安装 grpcurl：访问 GitHub 地址 按照说明进行安装。

2. 安装 MCP Grpcurl 包：

   go install github.com/wricardo/mcp-grpcurl@latest
   

3. 配置 Cline，将以下内容添加到 MCP 设置中：

   "mcp-grpcurl": {
     "command": "mcp-grpcurl",
     "env": {
       "ADDRESS": "localhost:8005"
     },
     "disabled": false,
     "autoApprove": []
   }
   

💻 使用示例

基础用法

mcp-grpc-client

高级用法

工具说明

• invoke：使用反射调用指定的 gRPC 方法。

  • 参数：
    • method：完全限定的方法名称（例如，package.Service/Method）。
    • request：方法请求的 JSON 格式数据。
    • headers：可选的 JSON 对象，用于传递自定义 gRPC 头部信息。

• list：列出目标服务器上所有可用的 gRPC 服务。

• describe：描述指定的 gRPC 服务或消息类型。支持使用点分法符号（例如，mypackage.MyService）。