v1.7.1

mcp v1.7.1

protoc-gen-mcp generates MCP (Model Context Protocol) server code from your
gRPC/Protobuf service definitions. Download the binary for your platform below.

Installation

Homebrew

brew install the-protobuf-project/tap/protoc-gen-mcp

Go install (plugin)

go install github.com/the-protobuf-project/mcp/plugin/cmd/protoc-gen-mcp@v1.7.1

Manual (macOS / Linux)

# Pick your platform, e.g. darwin_arm64 / linux_amd64
curl -LO https://github.com/the-protobuf-project/mcp/releases/download/v1.7.1/protoc-gen-mcp_1.7.1_darwin_arm64.tar.gz
tar -xzf protoc-gen-mcp_1.7.1_darwin_arm64.tar.gz
sudo mv protoc-gen-mcp /usr/local/bin/

Proto annotations

The MCP proto annotations are published to the Buf Schema Registry; add them
as a dependency and generate types in your own client:

# buf.yaml
deps:
  - buf.build/the-protobuf-project/mcp

Then reference the plugin from buf.gen.yaml:

plugins:
  - local: protoc-gen-mcp
    out: generated
    opt: [lang=go]   # go | rust | cpp | all

Changelog

Features

• 878d2ea: feat: add MCP protocol message definitions for application metadata, service options, prompts, tools, and progress reporting (@oh-tarnished)
• d233954: feat: add caching support to MCP services (@oh-tarnished)
• 16109f0: feat: add support for server-streaming RPCs with progress notifications (@oh-tarnished)
• 10f8bb3: feat: enhance Makefile with error checks for Rust crate and library (@oh-tarnished)
• 6fa3c9d: feat: include additional headers in grpc_server and todo_store examples (@oh-tarnished)

Bug Fixes

• 96bc34d: fix: refine cleanup process for generated C++ files in examples (@oh-tarnished)

Others

• 6e1e934: Add Google Protobuf linter job to CI workflow (@oh-tarnished)
• e59a2ef: Add conformance tests for MCP servers and implement Rust counter service (@oh-tarnished)
• e4eac8b: Merge pull request #116 from the-protobuf-project/chore/migrating-folder-stucture (@oh-tarnished)
• 7669471: Merge pull request #117 from the-protobuf-project/feat/adding-more-examples (@oh-tarnished)
• 5ece9ff: Merge pull request #118 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/pkg-config-0.3.34 (@oh-tarnished)
• 4898b57: Merge pull request #119 from the-protobuf-project/dependabot/github_actions/actions/cache-6 (@oh-tarnished)
• 41e438a: Migrate MCP protobuf files to v1 package structure and update annotations for compatibility (@oh-tarnished)
• 1b8cf63: Refactor MCP Protobuf Definitions (@oh-tarnished)
• 04a3a5d: Refactor proto files and CI configuration to streamline dependencies and enhance clarity (@oh-tarnished)
• 81ae91b: Remove deprecated MCP protobuf files and add new annotations for MCP service configuration (@oh-tarnished)
• b5e91de: Update README.md to reflect changes in MCP v1 annotations and service metadata (@oh-tarnished)
• a7cedaa: Updated the examples properly (@oh-tarnished)
• 7ad78cc: chore(deps): bump actions/cache from 4 to 6 (@dependabot[bot])
• 6dca68c: chore(deps): bump pkg-config in /examples/proto/generated/cpp/rust (@dependabot[bot])

v1.7.0

mcp v1.7.0

protoc-gen-mcp generates MCP (Model Context Protocol) server code from your
gRPC/Protobuf service definitions. Download the binary for your platform below.

Installation

Homebrew

brew install the-protobuf-project/tap/protoc-gen-mcp

Go install (plugin)

go install github.com/the-protobuf-project/mcp/plugin/cmd/protoc-gen-mcp@v1.7.0

Manual (macOS / Linux)

# Pick your platform, e.g. darwin_arm64 / linux_amd64
curl -LO https://github.com/the-protobuf-project/mcp/releases/download/v1.7.0/protoc-gen-mcp_1.7.0_darwin_arm64.tar.gz
tar -xzf protoc-gen-mcp_1.7.0_darwin_arm64.tar.gz
sudo mv protoc-gen-mcp /usr/local/bin/

Proto annotations

The MCP proto annotations are published to the Buf Schema Registry; add them
as a dependency and generate types in your own client:

# buf.yaml
deps:
  - buf.build/the-protobuf-project/mcp

Then reference the plugin from buf.gen.yaml:

plugins:
  - local: protoc-gen-mcp
    out: generated
    opt: [lang=go]   # go | python | rust | cpp | all

Changelog

Others

• e4fcfef: Add Protobuf definitions for MCP resources, progress, prompts, and service options (@oh-tarnished)
• dbd7a7c: Merge pull request #115 from the-protobuf-project/refactor/protokit-conversion (@oh-tarnished)
• a22ece8: Remove generated protobuf files for prompt, resource, and service options; add go.work.sum for dependency management (@oh-tarnished)
• b53d400: Remove runtime metadata, schema, server, and stream implementations (@oh-tarnished)
• 6286713: Resolve runtime-go/agents from the module proxy, not a sibling checkout (@oh-tarnished)
• 36de803: Update README.md to enhance clarity and detail for MCP protocol support (@oh-tarnished)

v1.6.2

grpc-mcp-gateway v1.6.2

protoc-gen-mcp generates MCP (Model Context Protocol) server code from your
gRPC/Protobuf service definitions. Download the binary for your platform below.

Installation

Homebrew

brew install the-protobuf-project/tap/protoc-gen-mcp

Go install (plugin)

go install github.com/the-protobuf-project/grpc-mcp-gateway/plugin/cmd/protoc-gen-mcp@v1.6.2

Manual (macOS / Linux)

# Pick your platform, e.g. darwin_arm64 / linux_amd64
curl -LO https://github.com/the-protobuf-project/grpc-mcp-gateway/releases/download/v1.6.2/protoc-gen-mcp_1.6.2_darwin_arm64.tar.gz
tar -xzf protoc-gen-mcp_1.6.2_darwin_arm64.tar.gz
sudo mv protoc-gen-mcp /usr/local/bin/

Proto annotations

The MCP proto annotations are published to the Buf Schema Registry; add them
as a dependency and generate types in your own client:

# buf.yaml
deps:
  - buf.build/the-protobuf-project/mcp

Then reference the plugin from buf.gen.yaml:

plugins:
  - local: protoc-gen-mcp
    out: generated
    opt: [lang=go]   # go | python | rust | cpp | all

Changelog

Others

• 6a2c6f8: Merge branch 'main' into dependabot/cargo/examples/rust/async-trait-0.1.91 (@oh-tarnished)
• 47c1812: Merge branch 'main' into dependabot/cargo/examples/rust/rmcp-3.1.1 (@oh-tarnished)
• 15185e5: Merge pull request #100 from the-protobuf-project/dependabot/cargo/examples/rust/tokio-1.53.1 (@oh-tarnished)
• f4e6377: Merge pull request #101 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/tokio-1.53.1 (@oh-tarnished)
• bc5f314: Merge pull request #102 from the-protobuf-project/dependabot/cargo/examples/rust/tokio-stream-0.1.19 (@oh-tarnished)
• 844b99d: Merge pull request #103 from the-protobuf-project/dependabot/cargo/examples/rust/serde_json-1.0.151 (@oh-tarnished)
• 3f225ef: Merge pull request #104 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/rmcp-3.0.1 (@oh-tarnished)
• 5fb3cdc: Merge pull request #106 from the-protobuf-project/dependabot/go_modules/google.golang.org/grpc-1.83.0 (@oh-tarnished)
• 7f64782: Merge pull request #107 from the-protobuf-project/dependabot/go_modules/github.com/modelcontextprotocol/go-sdk-1.7.0 (@oh-tarnished)
• 026eac8: Merge pull request #108 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/rmcp-3.1.1 (@oh-tarnished)
• ed43f09: Merge pull request #109 from the-protobuf-project/dependabot/cargo/examples/rust/rmcp-3.1.1 (@oh-tarnished)
• 5067d39: Merge pull request #87 from the-protobuf-project/dependabot/github_actions/bazel-contrib/publish-to-bcr/dot-github/workflows/publish.yaml-1.4.2 (@oh-tarnished)
• a9941df: Merge pull request #88 from the-protobuf-project/dependabot/go_modules/buf.build/gen/go/bufbuild/protovalidate/protocolbuffers/go-1.36.11-20260709200747-435963d16310.1 (@oh-tarnished)
• 0c8a39b: Merge pull request #90 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/rmcp-2.2.0 (@oh-tarnished)
• 2ce7dd5: Merge pull request #91 from the-protobuf-project/dependabot/github_actions/actions/setup-go-7 (@oh-tarnished)
• cd494d3: Merge pull request #92 from the-protobuf-project/dependabot/go_modules/google.golang.org/grpc-1.82.1 (@oh-tarnished)
• 3d16d7c: Merge pull request #93 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/cxx-1.0.198 (@oh-tarnished)
• b69f6ac: Merge pull request #94 from the-protobuf-project/dependabot/cargo/examples/rust/async-trait-0.1.91 (@oh-tarnished)
• 8d1fca4: Merge pull request #95 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/tokio-1.53.0 (@oh-tarnished)
• c5dc420: Merge pull request #96 from the-protobuf-project/dependabot/cargo/examples/rust/tokio-1.53.0 (@oh-tarnished)
• 9edc6a0: Merge pull request #97 from the-protobuf-project/dependabot/cargo/examples/rust/serde-1.0.229 (@oh-tarnished)
• 17eaaaa: Merge pull request #98 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/glob-0.3.4 (@oh-tarnished)
• 2b6c28d: Merge pull request #99 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/serde_json-1.0.151 (@oh-tarnished)
• dcec688: chore(deps): bump actions/setup-go from 6 to 7 (@dependabot[bot])
• 970abb0: chore(deps): bump async-trait from 0.1.89 to 0.1.91 in /examples/rust (@dependabot[bot])
• 2740794: chore(deps): bump bazel-contrib/publish-to-bcr/.github/workflows/publish.yaml (@dependabot[bot])
• b35be88: chore(deps): bump buf.build/gen/go/bufbuild/protovalidate/protocolbuffers/go (@dependabot[bot])
• 4d63c79: chore(deps): bump cxx in /examples/proto/generated/cpp/rust (@dependabot[bot])
• b83f7a7: chore(deps): bump github.com/modelcontextprotocol/go-sdk (@dependabot[bot])
• fd3a6d8: chore(deps): bump glob in /examples/proto/generated/cpp/rust (@dependabot[bot])
• 8e3da02: chore(deps): bump google.golang.org/grpc from 1.82.0 to 1.82.1 (@dependabot[bot])
• f10227e: chore(deps): bump google.golang.org/grpc from 1.82.1 to 1.83.0 (@dependabot[bot])
• a383a74: chore(deps): bump rmcp from 2.2.0 to 3.1.1 in /examples/rust (@dependabot[bot])
• 86cdfe7: chore(deps): bump rmcp in /examples/proto/generated/cpp/rust (@dependabot[bot])
• 15e0ed2: chore(deps): bump rmcp in /examples/proto/generated/cpp/rust (@dependabot[bot])
• 060577c: chore(deps): bump rmcp in /examples/proto/generated/cpp/rust (@dependabot[bot])
• ac67561: chore(deps): bump serde from 1.0.228 to 1.0.229 in /examples/rust (@dependabot[bot])
• f77a29d: chore(deps): bump serde_json from 1.0.150 to 1.0.151 in /examples/rust (@dependabot[bot])
• 763dcc2: chore(deps): bump serde_json in /examples/proto/generated/cpp/rust (@dependabot[bot])
• 236a2ad: chore(deps): bump tokio from 1.52.3 to 1.53.0 in /examples/rust (@dependabot[bot])
• e1fc268: chore(deps): bump tokio from 1.53.0 to 1.53.1 in /examples/rust (@dependabot[bot])
• 04c17bd: chore(deps): bump tokio in /examples/proto/generated/cpp/rust (@dependabot[bot])
• 19a6e53: chore(deps): bump tokio in /examples/proto/generated/cpp/rust (@dependabot[bot])
• 8113625: chore(deps): bump tokio-stream from 0.1.18 to 0.1.19 in /examples/rust (@dependabot[bot])
• e4af40b: chore(deps): update protoc-gen-mcp version to 1.6.2 and bump rmcp to 3.1 in generated files (@oh-tarnished)

v1.6.1

grpc-mcp-gateway v1.6.1

protoc-gen-mcp generates MCP (Model Context Protocol) server code from your
gRPC/Protobuf service definitions. Download the binary for your platform below.

Installation

Homebrew

brew install the-protobuf-project/tap/protoc-gen-mcp

Go install (plugin)

go install github.com/the-protobuf-project/grpc-mcp-gateway/plugin/cmd/protoc-gen-mcp@v1.6.1

Manual (macOS / Linux)

# Pick your platform, e.g. darwin_arm64 / linux_amd64
curl -LO https://github.com/the-protobuf-project/grpc-mcp-gateway/releases/download/v1.6.1/protoc-gen-mcp_1.6.1_darwin_arm64.tar.gz
tar -xzf protoc-gen-mcp_1.6.1_darwin_arm64.tar.gz
sudo mv protoc-gen-mcp /usr/local/bin/

Proto annotations

The MCP proto annotations are published to the Buf Schema Registry; add them
as a dependency and generate types in your own client:

# buf.yaml
deps:
  - buf.build/the-protobuf-project/mcp

Then reference the plugin from buf.gen.yaml:

plugins:
  - local: protoc-gen-mcp
    out: generated
    opt: [lang=go]   # go | python | rust | cpp | all

Changelog

Others

• 5446482: Merge branch 'main' into dependabot/cargo/examples/rust/rmcp-2.1.0 (@oh-tarnished)
• 62f6c4e: Merge pull request #82 from the-protobuf-project/dependabot/cargo/examples/rust/rmcp-2.1.0 (@oh-tarnished)
• ca1f3da: Merge pull request #83 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/rmcp-2.1.0 (@oh-tarnished)
• 74e48d8: Merge pull request #84 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/cxx-1.0.196 (@oh-tarnished)
• 7045a47: Merge pull request #85 from the-protobuf-project/dependabot/go_modules/google.golang.org/grpc-1.82.0 (@oh-tarnished)
• e281ad8: Merge pull request #86 from the-protobuf-project/refactor(mcp)-unary-interceptor-support (@oh-tarnished)
• 3519a30: Refactor MCP integration and enhance unary interceptor support (@oh-tarnished)
• 43cfe2c: Update generated files and dependencies to use protoc-gen-mcp v1.6.1-0.20260712043735 and rmcp version 2.2.0 (@oh-tarnished)
• a69b86e: Update rmcp and rmcp-macros to version 2.2.0 in Cargo.lock (@oh-tarnished)
• df4b1ad: chore(deps): bump cxx in /examples/proto/generated/cpp/rust (@dependabot[bot])
• 9630515: chore(deps): bump google.golang.org/grpc from 1.81.1 to 1.82.0 (@dependabot[bot])
• b645cc3: chore(deps): bump rmcp in /examples/proto/generated/cpp/rust (@dependabot[bot])
• 66a2201: fixed all the cpp examples with the newer update (@oh-tarnished)

v1.6.0

grpc-mcp-gateway v1.6.0

protoc-gen-mcp generates MCP (Model Context Protocol) server code from your
gRPC/Protobuf service definitions. Download the binary for your platform below.

Installation

Homebrew

brew install the-protobuf-project/tap/protoc-gen-mcp

Go install (plugin)

go install github.com/the-protobuf-project/grpc-mcp-gateway/plugin/cmd/protoc-gen-mcp@v1.6.0

Manual (macOS / Linux)

# Pick your platform, e.g. darwin_arm64 / linux_amd64
curl -LO https://github.com/the-protobuf-project/grpc-mcp-gateway/releases/download/v1.6.0/protoc-gen-mcp_1.6.0_darwin_arm64.tar.gz
tar -xzf protoc-gen-mcp_1.6.0_darwin_arm64.tar.gz
sudo mv protoc-gen-mcp /usr/local/bin/

Proto annotations

The MCP proto annotations are published to the Buf Schema Registry; add them
as a dependency and generate types in your own client:

# buf.yaml
deps:
  - buf.build/the-protobuf-project/mcp

Then reference the plugin from buf.gen.yaml:

plugins:
  - local: protoc-gen-mcp
    out: generated
    opt: [lang=go]   # go | python | rust | cpp | all

Changelog

Features

• 8f4ebcf: feat: GoReleaser/Homebrew distribution; consolidate proto package to (@oh-tarnished)
• 121cfb4: feat: GoReleaser/Homebrew distribution; consolidate proto package to mcp (@oh-tarnished)

Bug Fixes

• 825098b: fix: update badge link in README to reference the correct buf.build path (@oh-tarnished)

Others

• 939417a: Merge pull request #76 from the-protobuf-project/dependabot/github_actions/bazel-contrib/publish-to-bcr/dot-github/workflows/publish.yaml-1.4.1 (@oh-tarnished)
• ddd269a: Merge pull request #78 from the-protobuf-project/chore/fixing-project-structure (@oh-tarnished)
• c0e472f: Merge pull request #79 from the-protobuf-project/dependabot/github_actions/goreleaser/goreleaser-action-7 (@oh-tarnished)
• 89b0dbc: Merge pull request #80 from the-protobuf-project/dependabot/cargo/examples/proto/generated/cpp/rust/rmcp-1.8.0 (@oh-tarnished)
• ce4a3c1: Merge pull request #81 from the-protobuf-project/dependabot/cargo/examples/rust/rmcp-1.8.0 (@oh-tarnished)
• 0b6041d: Merge remote-tracking branch 'origin/main' into chore/fixing-project-structure (@oh-tarnished)
• f36febe: chore(deps): bump bazel-contrib/publish-to-bcr/.github/workflows/publish.yaml (@dependabot[bot])
• e572c6f: chore(deps): bump goreleaser/goreleaser-action from 6 to 7 (@dependabot[bot])
• 3877b84: chore(deps): bump rmcp from 1.7.0 to 1.8.0 in /examples/rust (@dependabot[bot])
• 597f69c: chore(deps): bump rmcp in /examples/proto/generated/cpp/rust (@dependabot[bot])
• 7dacb19: fixed issues with the CI and updated the package names (@oh-tarnished)
• c617157: fixed issues with the CI and updated the package names (@oh-tarnished)
• aca3f64: fixed the readme (@oh-tarnished)
• 2875e31: refactor: update repository references to the-protobuf-project (@oh-tarnished)
• 2cc532d: update examples package import from buf (@oh-tarnished)

v1.5.63

grpc-mcp-gateway v1.5.63

Installation

Go install (plugin):

go install github.com/machanirobotics/grpc-mcp-gateway/plugin/cmd/protoc-gen-mcp@v1.5.63

Python (pre-compiled proto types):

pip install grpc-mcp-gateway-protos==v1.5.63

Rust (pre-compiled proto types):

[dependencies]
mcp-protobuf = "v1.5.63"

Download binary:
Download the archive for your platform below, extract it, and place protoc-gen-mcp in your $PATH.

The version is baked into the binary via -ldflags and will appear in all generated file headers:

protoc-gen-mcp --version
# protoc-gen-mcp v1.5.63

Checksums

See checksums.txt for SHA-256 hashes of all archives.

Changes

Initial release

v1.5.62

grpc-mcp-gateway v1.5.62

Installation

Go install (plugin):

go install github.com/machanirobotics/grpc-mcp-gateway/plugin/cmd/protoc-gen-mcp@v1.5.62

Python (pre-compiled proto types):

pip install grpc-mcp-gateway-protos==v1.5.62

Rust (pre-compiled proto types):

[dependencies]
mcp-protobuf = "v1.5.62"

Download binary:
Download the archive for your platform below, extract it, and place protoc-gen-mcp in your $PATH.

The version is baked into the binary via -ldflags and will appear in all generated file headers:

protoc-gen-mcp --version
# protoc-gen-mcp v1.5.62

Checksums

See checksums.txt for SHA-256 hashes of all archives.

Changes

Initial release

v1.5.61

grpc-mcp-gateway v1.5.61

Installation

Go install (plugin):

go install github.com/machanirobotics/grpc-mcp-gateway/plugin/cmd/protoc-gen-mcp@v1.5.61

Python (pre-compiled proto types):

pip install grpc-mcp-gateway-protos==v1.5.61

Rust (pre-compiled proto types):

[dependencies]
mcp-protobuf = "v1.5.61"

Download binary:
Download the archive for your platform below, extract it, and place protoc-gen-mcp in your $PATH.

The version is baked into the binary via -ldflags and will appear in all generated file headers:

protoc-gen-mcp --version
# protoc-gen-mcp v1.5.61

Checksums

See checksums.txt for SHA-256 hashes of all archives.

Changes

Initial release

v1.5.6

grpc-mcp-gateway v1.5.6

Installation

Go install (plugin):

go install github.com/machanirobotics/grpc-mcp-gateway/plugin/cmd/protoc-gen-mcp@v1.5.6

Python (pre-compiled proto types):

pip install grpc-mcp-gateway-protos==v1.5.6

Rust (pre-compiled proto types):

[dependencies]
mcp-protobuf = "v1.5.6"

Download binary:
Download the archive for your platform below, extract it, and place protoc-gen-mcp in your $PATH.

The version is baked into the binary via -ldflags and will appear in all generated file headers:

protoc-gen-mcp --version
# protoc-gen-mcp v1.5.6

Checksums

See checksums.txt for SHA-256 hashes of all archives.

Changes

New

• feat: add CounterService support and update protobuf version to 7.34.1 (c370b1e)

Updated

• chore: update protoc-gen-mcp version to v1.5.52-0.20260422040626-c370b1e28f56 and adjust C++ build settings (3350d85)
• docs: update version references to v1.5.51 (739d52c)

Other

• Potential fix for pull request finding 'Unused import' (b8b7cc8)
• Potential fix for pull request finding 'Unused import' (a2f2b34)
• Potential fix for pull request finding 'Unused import' (cb0a906)
• Potential fix for pull request finding 'Unused import' (c692346)
• Potential fix for pull request finding 'Unused import' (993772c)
• Potential fix for pull request finding 'Unused import' (542ab26)
• Potential fix for pull request finding 'Unused import' (d4005da)

v1.5.51

grpc-mcp-gateway v1.5.51

Installation

Go install (plugin):

go install github.com/machanirobotics/grpc-mcp-gateway/plugin/cmd/protoc-gen-mcp@v1.5.51

Python (pre-compiled proto types):

pip install grpc-mcp-gateway-protos==v1.5.51

Rust (pre-compiled proto types):

[dependencies]
mcp-protobuf = "v1.5.51"

Download binary:
Download the archive for your platform below, extract it, and place protoc-gen-mcp in your $PATH.

The version is baked into the binary via -ldflags and will appear in all generated file headers:

protoc-gen-mcp --version
# protoc-gen-mcp v1.5.51

Checksums

See checksums.txt for SHA-256 hashes of all archives.

Changes

Initial release