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])