nogoo9 / mcp-server-cloud-fs / 25894592744

68%

Build Type

push

github

Committed by web-flow

Commit Message

feat: cloud-native v0.6.0 — new tools, multi-provider, audit logging, and full docs overhaul (#21)

* feat(errors): add structured cloud-aware error handling (#17)

Introduce CloudError class with typed error codes (RATE_LIMITED,
PERMISSION_DENIED, REGION_MISMATCH, BUCKET_NOT_FOUND, etc.) and
provider-specific error mapping functions for S3, Azure, and GCS.

- mapS3Error: maps AWS SDK error names to actionable CloudErrors
- mapAzureError: maps Azure status codes to CloudErrors
- mapGcsError: maps GCS error codes to CloudErrors
- Export CloudError and CloudErrorCode from lib.ts

Replaces opaque 'File not found' errors in provider catch blocks
with structured, actionable error messages that include suggestions
(e.g. 'Check IAM policy', 'Use --region').

* feat(tools): add read_file_chunk for byte-range reads (#12)

Add read_file_chunk tool that enables efficient partial reads of cloud
objects using native provider byte-range support (HTTP Range headers).

Features:
- start_byte (0-based, inclusive) and optional end_byte parameters
- utf8 and base64 encoding options
- File size metadata in response header (total bytes, range served)
- 10MB chunk size safety cap to prevent OOM
- Automatic end_byte clamping to file boundaries

Tests use real MemoryProvider + VFS (behavioral, not mock-coupled).

* feat(tools): add get_presigned_url for temporary access URLs (#14)

Add get_presigned_url tool for generating time-limited, authenticated
HTTPS URLs for cloud objects without exposing credentials.

- New optional getPresignedUrl() on StorageProvider interface
- S3 implementation using @aws-sdk/s3-request-presigner
- Supports 'get' (download) and 'put' (upload) operations
- Max expiration enforced at 86400s (24 hours)
- Clear error when provider doesn't support presigning
- New provider field on ServerContext for capability checking

Tests use real MemoryProvider (naturally lacks presigning) for
'unsupported' path, minimal mock augmentation for happy path.

* feat(... (continued)

Coverage Stats

707 of 1089 new or added lines in 14 files covered. (64.92%)

3 existing lines in 2 files now uncovered.

2956 of 4423 relevant lines covered (66.83%)

23.89 hits per line