使用说明

项目简介

MCP Grpcurl 是一个基于 Model Context Protocol (MCP) 构建的服务器，它利用 'grpcurl' 命令行工具，为 LLM 客户端提供与 gRPC 服务交互的能力。通过此 MCP 服务器，LLM 可以调用 gRPC 方法、查询 gRPC 服务列表以及获取 gRPC 服务和消息类型的详细描述。

主要功能点

调用 gRPC 方法 (invoke): 通过 gRPC 反射机制调用 gRPC 服务的方法，支持自定义请求头和 JSON 负载。
列出 gRPC 服务 (list): 检索目标 gRPC 服务器上所有可用的 gRPC 服务列表。
描述 gRPC 服务 (describe): 获取 gRPC 服务或消息类型的详细描述信息。
设置请求头 (set-headers): 设置全局请求头，应用于后续所有的 gRPC 请求。

安装步骤

安装 grpcurl: 请根据 grpcurl 官方仓库的指引安装 'grpcurl' 工具。

安装 MCP Grpcurl 服务器: 确保已安装 Go 1.23.0 或更高版本，然后运行以下命令安装 'mcp-grpcurl' 服务器：

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

服务器配置

在 MCP 客户端的配置中，添加以下 JSON 配置来启用和配置 'mcp-grpcurl' 服务器。你需要配置 'command' 指向 'mcp-grpcurl' 的可执行文件，并通过 'env' 设置 'ADDRESS' 环境变量来指定目标 gRPC 服务的地址。

"mcp-grpcurl": {
  "command": "mcp-grpcurl",
  "env": {
    "ADDRESS": "localhost:8005"  // 替换为你的 gRPC 服务地址，例如 "your-grpc-service.com:443"
  },
  "disabled": false,
  "autoApprove": []
}

基本使用方法

启动 'mcp-grpcurl' 服务器。如果已经正确安装，只需在终端中运行 'mcp-grpcurl' 命令即可启动服务器。服务器将通过标准输入/输出 (stdio) 与 MCP 客户端通信。
在 MCP 客户端中，配置并启用 'mcp-grpcurl' 服务器。客户端将根据配置连接到 'mcp-grpcurl' 服务器。
使用 MCP 客户端提供的界面或命令，调用 'mcp-grpcurl' 服务器提供的工具，例如 'invoke', 'list', 'describe' 等，与 gRPC 服务进行交互。具体工具的使用方法可以参考工具的描述信息。

关键词