mcp-grpc-transport-proto

KO | EN

gitlite — search

#hacktoberfest #react #ai #rust #java #windows #kubernetes #awesome-list #vue #pytorch #security #mcp #openai #open-source

mcp-grpc-transport-proto

(★ 14)

Proto for gRPC transport for MCP

mcp-grpc-transport-proto Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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)](https://modelcontextprotocol.io/) over gRPC.

The definitions are currently in sync with the MCP schema version [2025-11-25](https://github.com/modelcontextprotocol/modelcontextprotocol/tree/main/schema/2025-11-25).

For additional context, see: [gRPC as a Native Transport for MCP](https://cloud.google.com/blog/products/networking/grpc-as-a-native-transport-for-mcp).

## Repository Structure

*   `proto/`: Contains the raw Protocol Buffer definitions.
    *   [mcp.proto](file:///usr/local/google/home/bpawan/workspace/mcp-grpc-transport-proto/proto/mcp.proto): Defines the `Mcp` gRPC service.
    *   [mcp_messages.proto](file:///usr/local/google/home/bpawan/workspace/mcp-grpc-transport-proto/proto/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:
```bash
uv sync
# or
pip install .
```

### Running Examples
See the [examples/README.md](file:///usr/local/google/home/bpawan/workspace/mcp-grpc-transport-proto/examples/README.md) for details on running the basic usage example:
```bash
uv run python examples/basic_usage.py
```

### Generating Protos
If you modify the `.proto` files, you can regenerate the Python bindings by running:
```bash
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.

mcp-grpc-transport-proto

mcp-grpc-transport-proto Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

mcp-grpc-transport-proto

mcp-grpc-transport-proto Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README