Protoc Gen Ts Mcp

What is Protoc Gen Ts Mcp

protoc-gen-ts-mcp is a plugin for the protoc compiler that generates Model-Context-Protocol (MCP) servers in TypeScript from protocol buffer specifications. It enables AI models to interact with existing gRPC codebases using natural language, facilitating rapid prototyping and leveraging LLM capabilities.

Use cases

Use cases for protoc-gen-ts-mcp include developing AI-driven applications that need to communicate with gRPC services, prototyping new features using natural language, and enhancing existing applications with LLM capabilities.

How to use

To use protoc-gen-ts-mcp, ensure you have protoc version 3.20 or later installed. Follow the instructions in the README to install the plugin, run it, and set up an example MCP server like ‘mcp-vibe’. You will need to configure your MCP servers in a JSON format and run a client that connects to the MCP server.

Key features

Key features of protoc-gen-ts-mcp include seamless integration with gRPC applications, rapid server generation from protocol buffer definitions, and support for natural language interactions with AI models. The plugin also adheres to Semantic Versioning for stability.

Where to use

protoc-gen-ts-mcp can be used in fields that require AI model integration with existing gRPC services, such as machine learning applications, natural language processing, and any system that utilizes protocol buffers for data interchange.

protoc-gen-ts-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.