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

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"

• 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

1. Go to the Releases page
2. 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

Linux/macOS:

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

Windows:

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

mcp-proto-server --help

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"
      ]
    }
  }
}

Add to claude_desktop_config.json:

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

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.

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

Same as parent project