feat: add optional You.com MCP server integration

[mouse-value-add]

Overview

This PR adds You.com web search capabilities as an optional MCP server integration in ToolHive. You.com provides real-time web search, content extraction, and research capabilities that complement ToolHive's existing MCP server ecosystem.

What This Adds

Core Integration Files

• mcpserver_youcom_web.yaml: MCPServer configuration for You.com MCP server
• youcom_api_key_secret.yaml: Optional Secret template for API key authentication
• README_youcom.md: Comprehensive documentation and usage examples
• README.md: Updated examples directory documentation

Key Features

• Keyless operation: 100 free searches/day with no setup required
• Optional API key: Enhanced quotas and features with YDC_API_KEY
• Three MCP tools: you-search (web search), you-contents (URL extraction), you-research (multi-step research)
• SSE transport: Uses https://api.you.com/mcp endpoint
• Resource efficient: 50m CPU / 64Mi RAM requests

Why You.com Fits ToolHive

• Enterprise MCP platform alignment: ToolHive manages MCP servers; You.com provides search as an MCP server
• Optional integration: No impact on existing deployments - purely additive
• Both free and paid tiers: Keyless operation for evaluation, API keys for production
• Follows ToolHive patterns: Uses standard MCPServer CRD, secrets management, resource configuration

Usage Example

# Deploy (keyless operation - no setup needed)
kubectl apply -f examples/operator/mcp-servers/mcpserver_youcom_web.yaml

# Connect and search
thv run youcom-web
thv mcp call youcom-web you-search '{"query": "ToolHive MCP deployment best practices", "count": 10}'

Integration Benefits for ToolHive Users

• Current information: Web search brings real-time context to AI agents
• Research capabilities: Multi-step reasoning with citations and sources
• Content extraction: Fetch and process content from specific URLs
• Complements existing tools: Works alongside GitHub, database, and other MCP servers
• Low friction: Keyless tier allows immediate evaluation without credentials

Technical Implementation

• Uses ToolHive's existing MCPServer CRD patterns
• Follows established security practices (Secrets for credentials)
• Resource limits appropriate for search workloads
• Documentation follows ToolHive standards
• No changes to ToolHive core - pure configuration addition

Validation Performed

✅ YAML configuration files validate successfully
✅ Follows existing MCPServer example patterns
✅ Documentation is comprehensive with setup, usage, and troubleshooting
✅ Both keyless and authenticated operation modes documented
✅ Integration fits ToolHive's architectural patterns
✅ No breaking changes or core modifications

Links

• Tracking Issue: [Integration] stacklok/toolhive - You.com MCP server integration youdotcom-oss/integration-tracking#164
• You.com MCP Documentation: Referenced in implementation
• Integration follows: ToolHive MCPServer patterns established in existing examples

This integration demonstrates ToolHive's excellent extensibility while providing immediate value for users who need web search capabilities in their AI agent workflows.