stablekernel/protoc-gen-go-mcp

проток-ген-го-мкп

Это плагин Topeka для компилятора protoc, который генерирует сервер модели-контекста-протокола (MCP) на основе определения буфера протокола. Концептуально это позволяет модели ИИ использовать существующие кодовые базы gRPC с естественным языком, что позволяет быстро создавать прототипы и использовать возможности LLM для кодовых баз на основе протобуфа.

###Предпосылки Go 1.25 или более поздняя версия (сгенерированный импорт кода) Официальный MCP SDK, который требует этого.

• проток 29.3 (версия Проверка на прочность (см.). [[Т1]]
• проток-ген-го v1.36.6 и проток-ген-го-грпк v1.5.1 (точные версии, прикрепленные к директивам tool) [[Т3]]

Запуск плагина

Проверьте Makefile для явного использования команды. Используйте make generate для создания примера MCP-сервера из прото-файла.

####Отладка плагина

Отладчик будет запущен в безголовом режиме на порту 2345. Файл под [5] [[Воскресение]]. Вы можете подключиться к этому в VSCode В следующем [[Т6]].

####Проверка примера Установите пример mcp-vibe сервера

Добавьте сервер mcp-vibe к вашим серверам mcp:

protoc-gen-go-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

• Go 1.25 or later (the generated code imports the official MCP SDK, which requires it)
• protoc 29.3 (the version this plugin is tested against; see Makefile and AGENTS.md)
• protoc-gen-go v1.36.6 and protoc-gen-go-grpc v1.5.1 (the exact versions pinned as tool directives in go.mod)

Running the plugin

Check out the Makefile for explicit command usage. Use make generate to generate the example MCP server from the proto file.

Debugging the plugin

make start-debugger

Will start the delve debugger in headless mode on port 2345. The file under debug will be $GOPATH/bin/protoc-gen-go-mcp. You can connect to that in VSCode with the following launch.json configuration.

{
  "name": "Connect to protoc-gen-go-mcp plugin",
  "type": "go",
  "request": "attach",
  "mode": "remote",
  "remotePath": "${workspaceFolder}",
  "port": 2345,
  "host": "127.0.0.1"
}

Testing the example

Install the example mcp-vibe server

go install ./cmd/mcp-vibe

Add the mcp-vibe server to your mcp servers:

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

What the plugin generates

A generated NewMCPServer wraps a gRPC client and an *mcp.Server from the official Go MCP SDK. Once you’ve called RegisterDefaultTools() (or registered individual tools, see below), serve that *mcp.Server the way any MCP server is served. The two most common transports:

// client is a examplev1.VibeServiceClient for the backend gRPC service, e.g.
// examplev1.NewVibeServiceClient(conn) for a grpc.ClientConn.

// Over stdio, for CLI-launched MCP clients (see cmd/mcp-vibe/main.go for the
// full, runnable version of this).
stdioServer := mcp.NewServer(&mcp.Implementation{Name: "vibe", Version: "0.0.1"}, nil)
examplev1.NewVibeServiceMCPServer(client, stdioServer).RegisterDefaultTools()
if err := stdioServer.Run(ctx, &mcp.StdioTransport{}); err != nil {
	panic(err)
}