feat(logs): introduce retrieve_logs tool

[alexander-zuev]

retrieve_logs tool: access 10 Supabase log collections with filters and custom queries support

This PR introduces support for a new class of Logs & Analytics tools. The first tool in the series retrieve_logs tool allows users to easily retrieve logs from any log collection in Supabase, such as Auth, Postgres, PostgREST, Edge functions and many others. This will greatly aid in debugging and working with Supabase instance from the IDE / MCP client.

Other changes included in the PR:

• added file logger rotation (5MB)
• updated warnings and error messages and updated documentation to clarify SUPABASE_DB_REGION is required when connecting to a remote Supabase instance

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Documentation update
• Test updates

Checklist

• I have performed a self-review of my own code
• I have made corresponding changes to the documentation
• New and existing unit tests pass locally with my changes

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 85.85859% with 14 lines in your changes missing coverage. Please review.

Project coverage is 84.0%. Comparing base (0f6d8dd) to head (ca81586).

Files with missing lines	Patch %	Lines
supabase_mcp/services/database/postgres_client.py	58.8%	7 Missing ⚠️
supabase_mcp/tools/registry.py	28.5%	5 Missing ⚠️
supabase_mcp/services/logs/log_manager.py	94.7%	2 Missing ⚠️

@@           Coverage Diff           @@
##            main     #56     +/-   ##
=======================================
+ Coverage   83.8%   84.0%   +0.1%     
=======================================
  Files         25      26      +1     
  Lines       1602    1682     +80     
=======================================
+ Hits        1344    1413     +69     
- Misses       258     269     +11     

Files with missing lines	Coverage Δ
supabase_mcp/core/container.py	100.0% <100.0%> (ø)
supabase_mcp/logger.py	94.1% <100.0%> (+0.3%)	⬆️
supabase_mcp/services/api/api_manager.py	79.0% <100.0%> (+2.5%)	⬆️
supabase_mcp/services/database/sql/loader.py	100.0% <100.0%> (ø)
supabase_mcp/settings.py	94.0% <100.0%> (+4.0%)	⬆️
supabase_mcp/tools/manager.py	93.6% <100.0%> (+0.1%)	⬆️
supabase_mcp/services/logs/log_manager.py	94.7% <94.7%> (ø)
supabase_mcp/tools/registry.py	45.5% <28.5%> (-1.5%)	⬇️
supabase_mcp/services/database/postgres_client.py	87.3% <58.8%> (-4.2%)	⬇️

🚀 New features to boost your workflow:

• ❄ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.