stablekernel/protoc-gen-go-mcp

protoc gen 고 mcp

이것은 프로토콜 버퍼 정의를 기반으로 모델-context-protocol(MCP) 서버를 생성하는 protoc 컴파일러의 Topeka 플러그인입니다. Conceptually, 이것은 AI 모델을 사용하여 기존의 GRPC 코베이스를 사용하여 자연 언어를 사용하여 프로토 타이핑 및 protobuf 기반 코베이스에 대한 LLM 기능의 사용.

# 필수품

• 이동 1.25 이상 ( 생성 된 코드 가져 오기 필요한 공식 MCP SDK
• protoc 29.3 (이 버전은 플러그인은 테스트; Makefile을 참조 AGENTS.md)
• protoc-gen-go v1.36.6 과 protoc gen 고 grpc v1.5.1 (tool]] 지시어 go.mod)

플러그인 실행

지정된 명령 사용을위한 Makefile을 체크 아웃. make generate]을 사용하여 프로토 파일에서 MCP 서버를 생성합니다.

플러그인 디버깅

포트 2345에 headless 모드에서 delve debugger를 시작합니다. 아래 파일 디버그는 $GOPATH/bin/protoc-gen-go-mcp일 것입니다. VSCode에 연결할 수 있습니다. 다음으로 launch.json 구성.

예제 테스트

예제 설치 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)
}