grpcmcp MCP Server

@adiom-data

Repository

Basic information

About grpcmcp MCP Server

MCP Server for gRPC

#golang #mcp #grpc

grpcmcp MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

grpcmcp MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

Frequently asked questions

What gRPC methods does grpcmcp support?

Only unary gRPC methods are exposed as MCP tools. Client-streaming, server-streaming, and bidi-streaming methods are skipped.

What transports does grpcmcp support for client connections?

grpcmcp supports Streamable HTTP (default when `--hostport` is set), legacy SSE, and STDIN transport.

Can grpcmcp be used as a Go library?

Yes, it can be embedded via `grpcmcp.NewServer()` with a `Config` struct, allowing custom descriptor loading, HTTP clients, and dynamic header providers.

How does authentication work with grpcmcp?

Outbound backend auth is configured via `--bearer`, `--bearer-env`, or `--header` flags. For dynamic auth, use `ToolHeaderProvider` in library mode. Inbound MCP auth is handled by wrapping the HTTP handler with standard Go middleware.

How are 64-bit integers handled in MCP schemas?

With the `--string64` flag, 64-bit protobuf integer fields (`int64`, `uint64`, etc.) are exposed only as strings in MCP JSON schemas to avoid precision loss for JavaScript clients.

Comments

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.