docs: add complete production-ready MCP server example

Added a comprehensive example in examples/complete-server/ that demonstrates
all production patterns for building secure, observable MCP servers.

Features demonstrated:
- Bearer token authentication with middleware
- JSON-RPC 2.0 compliant error handling
- Request logging for all MCP protocol messages
- Health check endpoints for Kubernetes
- CORS configuration
- Proper notifications/initialized handling
- Response recording for debugging auth failures
- Dual gRPC/HTTP server architecture
- Production deployment patterns

The example is fully documented with:
- Comprehensive README with testing instructions
- Common issues and solutions section
- Kubernetes deployment manifests
- Architecture diagrams
- Step-by-step testing guide

This provides teams with a complete reference implementation
for building production MCP servers.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: Loschcode

README.md

@@ -151,6 +151,24 @@ curl -s http://localhost:8090/ \
 - Set timeouts on the HTTP server and gRPC client to avoid hanging tool calls.
 - Use structured logging by passing `WithRequestLogger` in your MCP mux.
 
+## Complete Production Example
+
+For a comprehensive, production-ready implementation showing all the best practices, see:
+
+**[examples/complete-server](./examples/complete-server/README.md)**
+
+This example demonstrates:
+- Bearer token authentication with JSON-RPC error handling
+- Request logging for all MCP protocol messages
+- Health check endpoints for Kubernetes
+- CORS configuration
+- Proper handling of `notifications/initialized`
+- Response recording for auth failure debugging
+- gRPC ↔ HTTP dual server architecture
+- Kubernetes deployment patterns
+
+Perfect for teams building production MCP servers.
+
 ## Example client (end-to-end)
 
 This repo includes a tiny MCP client that spawns the example server and calls the `echo` tool:

examples/complete-server/.gitignore

@@ -0,0 +1,13 @@
+# Binaries
+complete-server
+*.exe
+*.dll
+*.so
+*.dylib
+
+# Generated code
+*.pb.go
+*_mcp.pb.go
+
+# Go build artifacts
+go.sum