feat: Claude desktop and Amazon Q CLI integration

[vara-bonthu]

🔄 Pull Request

📝 Description

Brief description of changes and motivation.

Features Added:

• STDIO Transport Entry Point - Added main_stdio.py for Claude Desktop and Amazon Q CLI integration using official MCP SDK
• Claude Desktop Integration - Complete setup guide with configuration examples and 6 core analysis tools
• Amazon Q CLI Integration - Command-line Spark analysis with batch processing capabilities and automation examples
• Multi-Transport Architecture - Preserves existing FastMCP HTTP server while adding STDIO support for different client types

Improvements:

• Simplified Documentation - Consolidated scattered setup instructions into single clear paths
• Taskfile Integration - Updated all docs to use consistent task commands instead of mixed uv/shell scripts
• Tool Clarity - Clear distinction between 6 core STDIO tools vs 18 comprehensive HTTP tools
• Remote Server Support - Configuration guidance for connecting to production Spark History Servers

Fixes:

• Pre-commit Integration - Fixed Taskfile to use uv run pre-commit for consistent developer experience
• Code Quality - Resolved linting issues (bare except clauses, print statements) in STDIO entry point
• Path Resolution - Realistic path examples and clear replacement instructions for different environments

Docs:

• Removed Duplication - Eliminated redundant setup sections between main README and testing docs
• Streamlined Testing - Simplified TESTING.md from 3 approaches to 1 recommended path
• Integration Comparison - Added clear table showing transport types, entry points, and use cases
• Prerequisites Cleanup - Moved detailed setup to individual integration docs, kept main README focused

🎯 Type of Change

• 🐛 Bug fix (non-breaking change that fixes an issue)
• ✨ New feature (non-breaking change that adds functionality)
• 💥 Breaking change (fix or feature that would cause existing functionality to change)
• 📖 Documentation update
• 🧪 Test improvement
• 🔧 Refactoring (no functional changes)

🧪 Testing

• ✅ All existing tests pass (task test)
• 🔬 Tested with MCP Inspector
• 📊 Tested with sample Spark data
• 🚀 Tested with real Spark History Server (if applicable)

🔬 Test Commands Run

# Example:
# task test
# npx @modelcontextprotocol/inspector uv run main.py

🛠️ New Tools Added (if applicable)

• Tool Name: new_tool_name
• Purpose: What it does
• Usage: Example parameters

📸 Screenshots (if applicable)

✅ Checklist

• 🔍 Code follows project style guidelines
• 🧪 Added tests for new functionality
• 📖 Updated documentation (README, TESTING.md, etc.)
• 🔧 Pre-commit hooks pass
• 📝 Added entry to CHANGELOG.md (if significant change)

📚 Related Issues

Fixes #(issue number)
Related to #(issue number)

🤔 Additional Context

---

🎉 Thank you for contributing! Your effort helps make Spark monitoring more intelligent.

[nabuskey]

LGTM. I will look into supporting stdio mode without a separate file.