grpcmcp MCP Server

What is grpcmcp?

grpcmcp is an MCP server that proxies to a gRPC backend using a provided protobuf descriptor file or server reflection. It exposes unary gRPC methods as MCP tools for AI agents and clients.

How to use grpcmcp?

Install with go install github.com/adiom-data/grpcmcp, then run with flags like --reflect for reflection or --descriptors for a descriptor file. Use --hostport to serve over HTTP (Streamable HTTP or SSE) or configure via command/args in an MCP client for STDIN transport.

Key features of grpcmcp

• Proxies to gRPC backends using reflection or descriptor files
• Exposes unary gRPC methods as MCP tools
• Supports Streamable HTTP, legacy SSE, and STDIN transports
• Filters services with the --services flag
• Attaches Bearer tokens or custom headers to backend calls
• Can be embedded as a Go library

Use cases of grpcmcp

• Enable AI agents to call gRPC services via natural language
• Bridge existing gRPC infrastructure to MCP-compatible clients
• Expose selected gRPC endpoints through a controlled MCP interface