Metadata-Version: 2.4
Name: grpc-mcp-gateway-protos
Version: 1.5.6
Summary: Pre-compiled Protocol Buffer types for grpc-mcp-gateway (mcp.protobuf)
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/machanirobotics/grpc-mcp-gateway
Project-URL: Repository, https://github.com/machanirobotics/grpc-mcp-gateway
Keywords: grpc,mcp,protobuf,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: protobuf>=7.34.1

# grpc-mcp-gateway-protos

Pre-compiled Protocol Buffer types for [grpc-mcp-gateway](https://github.com/machanirobotics/grpc-mcp-gateway) — the `mcp.protobuf` package containing MCP annotations for gRPC services.

## Install

Use the version matching the [grpc-mcp-gateway release](https://github.com/machanirobotics/grpc-mcp-gateway/releases) you use:

```bash
# Latest
pip install grpc-mcp-gateway-protos

# Or pin to a specific release (matches gateway / GitHub release tag without v)
pip install grpc-mcp-gateway-protos==1.5.51
```

## What's included

This package provides the Python bindings for:

- **`mcp.protobuf.annotations`** — Service, tool, prompt, elicitation, and field options for annotating `.proto` files
- **`mcp.protobuf.service_options`** — App metadata (`MCPServiceOptions`)
- **`mcp.protobuf.prompt`** — Prompt templates (`MCPPrompt`, `MCPToolOptions`)
- **`mcp.protobuf.elicitation`** — Confirmation dialogs (`MCPElicitation`)
- **`mcp.protobuf.resource`** — Resource definitions (`MCPResource`, `MCPMimeType`)
- **`mcp.protobuf.app`** — App info (`MCPApp`)
- **`mcp.protobuf.field`** — Field description option (`MCPFieldOptions`)
- **`mcp.protobuf.enum`** — Enum and enum-value descriptions (`MCPEnumOptions`, `MCPEnumValueOptions`)
- **`mcp.protobuf.progress`** — Progress notifications (`MCPProgress`) for server-streaming RPCs
- **`mcp.protobuf.field_type`** — Field type enums

## Usage

Import the annotations to register the proto extensions (required for generated code that uses MCP options):

```python
# In your generated _pb2.py or before using MCP-annotated protos
import mcp.protobuf.annotations_pb2  # noqa: F401 — registers extensions
```

When using [protoc-gen-mcp](https://github.com/machanirobotics/grpc-mcp-gateway) with `lang=python`, the generated code will depend on this package. Add it to your project:

```toml
# pyproject.toml
[project]
dependencies = [
    "grpc-mcp-gateway-protos",
    # ...
]
```

## Links

- **Source**: [github.com/machanirobotics/grpc-mcp-gateway](https://github.com/machanirobotics/grpc-mcp-gateway)
- **Proto definitions**: [buf.build/machanirobotics/grpc-mcp-gateway](https://buf.build/machanirobotics/grpc-mcp-gateway)
- **License**: Apache-2.0
