Model Context Protocol (MCP) - gRPC Transport Protobuf Definitions

This repository contains the Protocol Buffer definitions (.proto) and generated Python bindings for implementing the Model Context Protocol (MCP) over gRPC.

The definitions are currently in sync with the MCP schema version 2025-11-25.

For additional context, see: gRPC as a Native Transport for MCP.

Repository Structure

• proto/: Contains the raw Protocol Buffer definitions.
  • mcp.proto: Defines the Mcp gRPC service.
  • mcp_messages.proto: Defines the request/response payloads.
• src/mcp_grpc_transport_proto/: The generated Python package containing the compiled Protobuf and gRPC code.
• generate.py: A utility script to compile the .proto files into the Python package.
• examples/: Contains example Python code demonstrating how to construct and use these messages.

Getting Started (Python)

Prerequisites

• Python 3.9+
• uv (recommended) or pip

Installation

To install the package in editable mode:

uv sync
# or
pip install .

Running Examples

See the examples/README.md for details on running the basic usage example:

uv run python examples/basic_usage.py

Generating Protos

If you modify the .proto files, you can regenerate the Python bindings by running:

uv run python generate.py

Usage in Other Languages

Because these are standard Protocol Buffers, you can generate client and server stubs for any gRPC-supported language (Go, Java, Rust, C++, Node.js, etc.) using protoc with the appropriate plugins.

Evolution and Compatibility

This schema is designed to evolve alongside the official MCP specification.

• Only non-breaking changes (such as adding optional fields) will be made.
• The schema avoids protobuf oneof fields to ensure forward compatibility when new message types are added.