GCP MCP Server

# 🚀 GCP MCP Server v1.0.0 - Production Ready! We're excited to announce the first stable release of the **GCP MCP Server** - a powerful Model Context Protocol server that brings Google Cloud Platform integration to AI assistants like Claude Code! ## 🌟 What is GCP MCP Server? The GCP MCP Server enables AI assistants to interact directly with your Google Cloud Platform services, making cloud operations, debugging, and monitoring as simple as asking a question in natural language. **Perfect for:** - 🔍 **DevOps Engineers** - Quick log analysis and troubleshooting - 🛠️ **Developers** - Real-time error investigation and debugging - 📊 **SREs** - Performance monitoring and root cause analysis - ☁️ **Cloud Architects** - Multi-project analytics and optimization ## ✨ Key Features ### 🔌 **Seamless Integration** - **One-command setup** with Claude Code - **16 powerful tools** for logging and monitoring - **Multi-platform support** (Windows, macOS, Linux) - **Docker deployment** ready ### 📊 **Comprehensive GCP Coverage** - **Cloud Logging** with advanced analytics - **Cloud Monitoring** with SLA/SLO analysis - **Error Reporting** with pattern detection - **Multi-project support** for enterprise environments ### 🛡️ **Enterprise-Grade Security** - No hardcoded credentials - Comprehensive input validation - Security scanning with every release - Best practices documentation ### 🚀 **Production Ready** - **100% test coverage** with automated CI/CD - **Cross-platform compatibility** - **Comprehensive documentation** - **Performance optimized** with caching and rate limiting ## 🔧 Available Tools ### Basic Logging Tools (4 tools) - `query_logs` - Query GCP Cloud Logging with filters - `analyze_error_logs` - Analyze error patterns and trends - `get_recent_errors` - Get latest errors for quick troubleshooting - `search_logs_by_message` - Search logs by text content ### Enterprise Logging Tools (6 tools) - `advanced_log_query` - Multi-project complex queries - `error_root_cause_analysis` - Comprehensive RCA workflows - `security_log_analysis` - Security event analysis - `performance_log_analysis` - Performance troubleshooting - `log_pattern_discovery` - Automated anomaly detection - `cross_service_trace_analysis` - Distributed tracing ### Monitoring Tools (6 tools) - `advanced_metrics_query` - Custom metrics analysis - `sla_slo_analysis` - SLA/SLO monitoring and reporting - `alert_policy_analysis` - Alert effectiveness analysis - `resource_optimization_analysis` - Cost optimization insights - `custom_dashboard_metrics` - Dashboard generation - `infrastructure_health_check` - Comprehensive health checks ## 🚀 Quick Start ### Installation ```bash pip install gcp-mcp ``` ### Claude Code Integration (One Command!) ```bash claude mcp add gcp-logs -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json -- python3.11 -m gcp_mcp.cli --project YOUR_PROJECT_ID ``` ### Docker Deployment ```bash docker run -e GOOGLE_APPLICATION_CREDENTIALS=/creds/key.json -v /path/to/creds:/creds ghcr.io/jayrajgoyal/gcp-mcp:latest ``` ## 💬 Example Usage **Ask Claude Code:** > "Show me the last 10 error logs from my production environment" > "Analyze the performance issues in my application over the past hour" > "Find all logs related to user ID 12345 in the last 24 hours" > "What are the top 5 error patterns this week?" ## 🏆 Why Choose GCP MCP Server? ### ⚡ **Instant Productivity** - Transform complex GCP operations into simple conversations - No need to remember complex log query syntax - Get insights faster than traditional monitoring tools ### 🔒 **Secure by Design** - Built with security best practices - Uses your existing GCP IAM permissions - No data stored outside your GCP environment ### 🌍 **Community Driven** - Open source and MIT licensed - Actively maintained and updated - Comprehensive documentation and examples ### 🏢 **Enterprise Ready** - Multi-project support - Performance optimized - Comprehensive testing and CI/CD - Professional support available ## 📊 Technical Highlights - **Languages**: Python 3.10+ - **Architecture**: Async/await for high performance - **Testing**: 100% test pass rate - **Security**: Bandit security scanning - **Documentation**: Comprehensive guides and API docs - **CI/CD**: GitHub Actions with multi-platform testing ## 🎯 Roadmap **Coming Soon:** - **BigQuery integration** for data analytics - **Cloud SQL tools** for database management - **Kubernetes Engine support** for container operations - **Cloud Storage utilities** for file operations - **Cost analysis tools** for optimization ## 🤝 Community & Support - **Documentation**: [GitHub README](https://github.com/JayRajGoyal/gcp-mcp#readme) - **Issues**: [GitHub Issues](https://github.com/JayRajGoyal/gcp-mcp/issues) - **Discussions**: [GitHub Discussions](https://github.com/JayRajGoyal/gcp-mcp/discussions) - **Contributing**: [Contributing Guide](https://github.com/JayRajGoyal/gcp-mcp/blob/main/CONTRIBUTING.md) ## 👨‍💻 About the Author Created by **Jayraj Goyal** (jayrajiitr.16@gmail.com) - passionate about making cloud operations more accessible through AI. ## 🎉 Get Started Today! ```bash # Install pip install gcp-mcp # Set up with Claude Code claude mcp add gcp-logs -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json -- python3.11 -m gcp_mcp.cli --project YOUR_PROJECT_ID # Start asking questions! ``` **Star ⭐ the repository if you find it useful!** --- **Full Changelog**: https://github.com/JayRajGoyal/gcp-mcp/blob/main/CHANGELOG.md