Protoc Gen Py Mcp

What is Protoc Gen Py Mcp

protoc-gen-py-mcp is a protoc plugin that generates MCP servers in Python from a protocol buffer specification, enabling AI models to utilize existing gRPC codebases with natural language.

Use cases

Use cases include developing AI-driven applications that leverage existing gRPC services, creating prototypes for LLM capabilities, and enhancing communication between AI models and backend services.

How to use

To use protoc-gen-py-mcp, install the protoc compiler version 3.20 or later, and run the plugin to generate MCP servers based on your protocol buffer definitions. Detailed instructions for running and debugging the plugin will be provided in the future.

Key features

Key features include seamless integration with existing gRPC applications, rapid prototyping capabilities for AI models, and the ability to generate servers that adhere to the Model-Context-Protocol (MCP) specifications.

Where to use

protoc-gen-py-mcp can be used in fields such as AI development, software engineering, and any application that requires integration of natural language processing with gRPC-based services.

protoc-gen-py-mcp

This is a Topeka plugin for the protoc compiler that generates a model-context-protocol(MCP) server based on a protocol buffer definition. Conceptually, this allows an AI model to use existing gRPC codebases with natural language, allowing for rapid prototyping and usage of LLM capabilities for protobuf based codebases.

Prerequisites

• protoc 3.20 or later
  [TODO: add all prerequisites to successfully build and run the plugin]

Running the plugin

[TODO: add instructions to run the plugin]

Debugging the plugin

[TODO: add instructions to debug the plugin]

Testing the example

Install the example mcp-vibe server
[TODO: add instructions to run the project specific example server]
Add the mcp-vibe server to your mcp servers:

{
  "mcpServers": {
    "vibe": {
      "command": "mcp-vibe"
    }
  }
}

and run a client with above mcp server attached (eg. claude desktop)

Topeka

Topeka is an open source project that provides code-generators for Model-Context-Protocol (MCP).
It is designed to facilitate the usage of MCP seamlessly against existing gRPC based applications. This is done via
leveraging code generation using the protoc compiler and installing the relevant Topeka plugin.

The plugins follow Semantic Versioning and any plugin prior to 1.0.0 releases ARE still subject to breaking changes. Please note, this is
applied to the generated servers, not the plugins themselves, which do not provide public APIs. This project reserves the right to change how code generation is achieved,
while maintaining stable MCP server APIs.

Maintainers

Stable Kernel is the primary maintainer of this project and sponsor of the plugins, though we welcome outside contributions.

Stable Kernel is a digital transformation company building solutions that power LLM enablement for growing businesses. We have a track record of helping our partners solve their biggest challenges on their digital journey, whether they need insights or implementation. Every day, millions of people rely on software that we developed, and our custom software development and technology services have been trusted by some of the most innovative Fortune 500 companies in the world.