ggRMCP

ggRMCP

High-performance gateway converting gRPC services into MCP tools for AI access.

20
Stars
2
Forks
0
Releases

Overview

ggRMCP is a high-performance Go gateway that translates gRPC services into MCP-compatible tools, enabling AI models to call your gRPC endpoints directly without modifying the services. It acts as a translator between the gRPC world and the MCP ecosystem, performing dynamic tool generation from service definitions and supporting both gRPC reflection and pre-built FileDescriptorSet descriptors to suit different workflows. Each discovered gRPC method is registered as an MCP tool with input/output schemas derived from protobuf definitions, automatic validation, and built-in documentation extracted from comments when available. The gateway translates JSON requests to protobuf, forwards selected HTTP headers as gRPC metadata with security filtering, and converts responses back to JSON while mapping gRPC errors to MCP errors. Its architecture emphasizes dynamic tool generation, schema generation from protobufs to JSON, and rich tool descriptions leveraging comments from descriptors. Deployment options include a sidecar proxy that coexists with any language and a centralized gateway serving multiple backends. It remains experimental with quick-start examples for a Hello service.

Details

Owner
aalobaidi
Language
Go
License
MIT License
Updated
2025-12-07

Features

Language Agnostic

Works as a sidecar with gRPC services in any language.

Seamless Integration

Connect existing gRPC services to AI applications without modification.

Sidecar Ready

Deploy alongside your service containers with zero code changes.

Dynamic Service Discovery

Automatic gRPC service discovery using gRPC server reflection or FileDescriptorSet.

Real-time Tool Generation

Dynamically generate MCP tools from gRPC service definitions with comment extraction.

Schema Validation

Automatic request/response validation using protobuf schemas.

Session Management

Stateful session handling for complex AI interactions.

Header Forwarding

Configurable HTTP header forwarding to gRPC services with security filtering.

Audience

AI DevelopersExpose gRPC services to AI apps as MCP tools for immediate access.
Claude IntegratorsEnable Claude to discover and call gRPC methods via MCP gateway.
DevOps EngineersDeploy as a sidecar or centralized gateway to enable AI tooling.

Tags

gRPCMCPgatewayFileDescriptorSetgRPC reflectionJSON schemasheader forwardingProtobufAI integrationsidecarGo