MCP Proto Server

A high-performance Protocol Buffer indexing and search server that integrates with AI coding assistants through the Model Context Protocol (MCP).

🎯 What It Does

MCP Proto Server makes your Protocol Buffer definitions instantly searchable and accessible to AI assistants like Claude and Cursor. Instead of manually looking through .proto files, you can ask questions like:

"Show me all authentication-related services"
"What fields does the User message have?"
"Find RPCs that handle payment processing"

🚀 Key Features

Instant Search: Find services, messages, and fields across all your proto files
Smart Type Resolution: Automatically resolves nested types and dependencies
AI Integration: Works seamlessly with Claude Desktop and Cursor
Lightning Fast: Sub-millisecond search performance
Zero Dependencies: Single executable, no runtime requirements

📦 Installation

Download Latest Release

Go to the Releases page
Download the appropriate package for your system:
- Linux: mcp-proto-server-linux-amd64.tar.gz
- macOS Intel: mcp-proto-server-macos-amd64.tar.gz
- macOS Apple Silicon: mcp-proto-server-macos-arm64.tar.gz
- Windows: mcp-proto-server-windows-amd64.zip

Install

Linux/macOS:

tar -xzf mcp-proto-server-*.tar.gz
./install.sh

Windows:

# Extract the zip file, then run:
install-windows.bat

Verify Installation

mcp-proto-server --help

🔧 Setup with AI Assistants

Cursor Configuration

Add to your Cursor MCP config (~/.cursor/mcp.json):

{
  "mcpServers": {
    "proto-server": {
      "command": "mcp-proto-server",
      "args": ["-root", "/path/to/your/proto/files"],
      "capabilities": [
        "search_proto: Fuzzy search across all proto definitions",
        "get_service_definition: Get service with ALL nested types in one call",
        "get_message_definition: Get message with ALL nested types in one call"
      ]
    }
  }
}

Claude Desktop Configuration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "proto-server": {
      "command": "mcp-proto-server",
      "args": ["-root", "/path/to/your/proto/files"]
    }
  }
}

🎯 How to Use

Once configured, simply ask your AI assistant questions about your Protocol Buffer definitions:

"What services are available in the auth package?"
"Show me the complete structure of the Product message"
"Find all RPCs that return user data"

The server automatically indexes your proto files and provides instant, intelligent search results.

📁 Project Structure

go-version/ - High-performance Go implementation (recommended)
python-version/ - Python implementation (legacy)

📄 License

Same as parent project

mcp-proto