converteverything-mcp 2.1.0 → 2.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +36 -2
- package/dist/client.d.ts +24 -54
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +168 -296
- package/dist/client.js.map +1 -1
- package/dist/index.js +39 -79
- package/dist/index.js.map +1 -1
- package/dist/types.d.ts +2 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +3 -3
- package/dist/types.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -17,7 +17,6 @@ Tired of sketchy converter websites with popup ads and "premium" upsells? We bui
|
|
|
17
17
|
## Features
|
|
18
18
|
|
|
19
19
|
- **100+ Supported Formats**: Audio, video, image (including RAW camera formats), document, ebook, data, 3D, font, archive, and CAD files
|
|
20
|
-
- **Large File Support**: Convert files up to 10GB with optimized direct cloud upload
|
|
21
20
|
- **File Compression**: Compress images, videos, and PDFs with quality presets
|
|
22
21
|
- **Archive Creation**: Create ZIP, TAR, 7z archives from multiple files
|
|
23
22
|
- **File Sharing**: Generate shareable links and send files via email
|
|
@@ -70,6 +69,19 @@ Browse all [audio converters](https://converteverything.io/audio-converters), [v
|
|
|
70
69
|
- Silver ($9.99/mo): 400 API calls/day
|
|
71
70
|
- Gold ($24.99/mo): Unlimited API calls
|
|
72
71
|
|
|
72
|
+
### File Retention
|
|
73
|
+
|
|
74
|
+
Converted files are stored temporarily. Use the `retention_hours` parameter to control how long files are kept:
|
|
75
|
+
|
|
76
|
+
| Tier | Max Retention |
|
|
77
|
+
|------|---------------|
|
|
78
|
+
| Free/Basic | 24 hours |
|
|
79
|
+
| Bronze | 7 days (168 hours) |
|
|
80
|
+
| Silver | 15 days (360 hours) |
|
|
81
|
+
| Gold | 30 days (720 hours) |
|
|
82
|
+
|
|
83
|
+
Default retention is 24 hours if not specified.
|
|
84
|
+
|
|
73
85
|
## Installation
|
|
74
86
|
|
|
75
87
|
### From npm (recommended)
|
|
@@ -448,6 +460,7 @@ Claude: [Uses compress_image] Compressed from 5.2 MB to 1.1 MB (79% reduction)
|
|
|
448
460
|
- `file_path` (required): Path to the image file
|
|
449
461
|
- `quality` (optional): Quality level 1-100 (default: 80)
|
|
450
462
|
- `max_dimension` (optional): Max width/height in pixels
|
|
463
|
+
- `retention_hours` (optional): File retention 1-720 hours (default: 24, max based on tier)
|
|
451
464
|
|
|
452
465
|
### `compress_video`
|
|
453
466
|
|
|
@@ -464,6 +477,7 @@ Claude: [Uses compress_video] Compressed from 500 MB to 85 MB
|
|
|
464
477
|
- `preset` (optional): Speed preset (ultrafast, fast, medium, slow)
|
|
465
478
|
- `max_resolution` (optional): Max resolution (e.g., "1920x1080", "720p")
|
|
466
479
|
- `remove_audio` (optional): Remove audio track
|
|
480
|
+
- `retention_hours` (optional): File retention 1-720 hours (default: 24, max based on tier)
|
|
467
481
|
|
|
468
482
|
### `compress_pdf`
|
|
469
483
|
|
|
@@ -476,7 +490,8 @@ Claude: [Uses compress_pdf] Compressed from 25 MB to 3.2 MB
|
|
|
476
490
|
|
|
477
491
|
**Parameters:**
|
|
478
492
|
- `file_path` (required): Path to the PDF file
|
|
479
|
-
- `quality` (optional):
|
|
493
|
+
- `quality` (optional): Compression quality: low, medium, high (default: medium)
|
|
494
|
+
- `retention_hours` (optional): File retention 1-720 hours (default: 24, max based on tier)
|
|
480
495
|
|
|
481
496
|
### `get_compression_usage`
|
|
482
497
|
|
|
@@ -505,6 +520,7 @@ Claude: [Uses create_archive] Created project.zip with 12 files (45 MB)
|
|
|
505
520
|
- `output_format` (optional): zip, tar, tar.gz, tar.bz2, or 7z (default: zip)
|
|
506
521
|
- `archive_name` (optional): Custom name for the archive
|
|
507
522
|
- `compression_level` (optional): 1-9 (default: 6)
|
|
523
|
+
- `retention_hours` (optional): File retention 1-720 hours (default: 24, max based on tier)
|
|
508
524
|
|
|
509
525
|
---
|
|
510
526
|
|
|
@@ -820,6 +836,23 @@ Claude: [Uses get_supported_formats]
|
|
|
820
836
|
You can convert to these video formats: mp4, avi, mkv, mov, webm, wmv, flv, m4v, 3gp, ts, vob, mts, mpeg, m2ts, divx
|
|
821
837
|
```
|
|
822
838
|
|
|
839
|
+
## Large File Handling
|
|
840
|
+
|
|
841
|
+
As of version 2.1.0, the MCP server automatically handles large files using **chunked uploads**:
|
|
842
|
+
|
|
843
|
+
- **Files > 30MB** are automatically split into 10MB chunks
|
|
844
|
+
- **Parallel uploads** (3 concurrent) for faster transfer speeds
|
|
845
|
+
- **Better reliability** - failed chunks can be retried without restarting the entire upload
|
|
846
|
+
- **Memory efficient** - only one chunk is loaded into memory at a time
|
|
847
|
+
|
|
848
|
+
This is transparent to users - just use `convert_file` as normal and the server handles the rest.
|
|
849
|
+
|
|
850
|
+
```
|
|
851
|
+
User: Convert my 500MB video to MP4
|
|
852
|
+
Claude: [Uses convert_file - automatically uses chunked upload for large files]
|
|
853
|
+
Starting conversion... (uploading in 50 chunks)
|
|
854
|
+
```
|
|
855
|
+
|
|
823
856
|
## Security
|
|
824
857
|
|
|
825
858
|
This MCP server:
|
|
@@ -829,6 +862,7 @@ This MCP server:
|
|
|
829
862
|
- Sanitizes filenames before upload
|
|
830
863
|
- Uses HTTPS for all API communication
|
|
831
864
|
- Does not store any files or credentials
|
|
865
|
+
- Uses chunked uploads for large files (>30MB) for reliability
|
|
832
866
|
|
|
833
867
|
Your files are:
|
|
834
868
|
- Encrypted in transit (HTTPS/TLS)
|
package/dist/client.d.ts
CHANGED
|
@@ -66,7 +66,8 @@ export declare class ConvertEverythingClient {
|
|
|
66
66
|
*/
|
|
67
67
|
private validateFilePath;
|
|
68
68
|
/**
|
|
69
|
-
* Convert a file from a local path
|
|
69
|
+
* Convert a file from a local path.
|
|
70
|
+
* Automatically uses chunked upload for files >30MB for better reliability.
|
|
70
71
|
*/
|
|
71
72
|
convertFile(filePath: string, targetFormat: string, options?: ConversionOptions): Promise<ConversionResponse>;
|
|
72
73
|
/**
|
|
@@ -118,33 +119,25 @@ export declare class ConvertEverythingClient {
|
|
|
118
119
|
*/
|
|
119
120
|
retryConversion(conversionId: string, newOptions?: ConversionOptions): Promise<ConversionResponse>;
|
|
120
121
|
/**
|
|
121
|
-
* Compress
|
|
122
|
-
*/
|
|
123
|
-
private compressLargeFile;
|
|
124
|
-
/**
|
|
125
|
-
* Compress an image file (smart - uses direct upload for large files)
|
|
122
|
+
* Compress an image file
|
|
126
123
|
*/
|
|
127
124
|
compressImage(filePath: string, options?: CompressionOptions): Promise<ConversionResponse>;
|
|
128
125
|
/**
|
|
129
|
-
* Compress a video file
|
|
126
|
+
* Compress a video file
|
|
130
127
|
*/
|
|
131
128
|
compressVideo(filePath: string, options?: CompressionOptions): Promise<ConversionResponse>;
|
|
132
129
|
/**
|
|
133
|
-
* Compress a PDF file
|
|
130
|
+
* Compress a PDF file
|
|
134
131
|
*/
|
|
135
|
-
compressPdf(filePath: string, quality?: "low" | "medium" | "high"): Promise<ConversionResponse>;
|
|
132
|
+
compressPdf(filePath: string, quality?: "low" | "medium" | "high", retentionHours?: number): Promise<ConversionResponse>;
|
|
136
133
|
/**
|
|
137
134
|
* Get compression usage statistics
|
|
138
135
|
*/
|
|
139
136
|
getCompressionUsage(): Promise<CompressionUsageResponse>;
|
|
140
137
|
/**
|
|
141
|
-
* Create an archive from multiple files
|
|
138
|
+
* Create an archive from multiple files
|
|
142
139
|
*/
|
|
143
140
|
createArchive(filePaths: string[], options?: ArchiveOptions): Promise<ConversionResponse>;
|
|
144
|
-
/**
|
|
145
|
-
* Create archive from large files using direct upload
|
|
146
|
-
*/
|
|
147
|
-
private createArchiveLargeFiles;
|
|
148
141
|
/**
|
|
149
142
|
* Reconvert an existing conversion with new settings
|
|
150
143
|
*/
|
|
@@ -197,57 +190,34 @@ export declare class ConvertEverythingClient {
|
|
|
197
190
|
*/
|
|
198
191
|
importAndConvert(provider: CloudProvider, fileId: string, fileName: string, targetFormat: string, options?: ConversionOptions): Promise<ConversionResponse>;
|
|
199
192
|
/**
|
|
200
|
-
*
|
|
201
|
-
*/
|
|
202
|
-
requiresDirectUpload(fileSize: number): boolean;
|
|
203
|
-
/**
|
|
204
|
-
* Get presigned URL for direct upload to R2
|
|
205
|
-
*/
|
|
206
|
-
private getPresignedUrl;
|
|
207
|
-
/**
|
|
208
|
-
* Upload file directly to R2 using presigned URL
|
|
209
|
-
*/
|
|
210
|
-
private uploadToR2;
|
|
211
|
-
/**
|
|
212
|
-
* Start conversion from a directly uploaded file
|
|
193
|
+
* Validate UUID format
|
|
213
194
|
*/
|
|
214
|
-
private
|
|
195
|
+
private isValidUuid;
|
|
215
196
|
/**
|
|
216
|
-
*
|
|
217
|
-
*
|
|
218
|
-
* This method uses a three-step process optimized for large files:
|
|
219
|
-
* 1. Get a presigned URL for direct upload
|
|
220
|
-
* 2. Upload the file directly to cloud storage
|
|
221
|
-
* 3. Start the conversion from the uploaded file
|
|
222
|
-
*
|
|
223
|
-
* Benefits:
|
|
224
|
-
* - Faster uploads through direct cloud connectivity
|
|
225
|
-
* - Support for files up to 10GB (tier dependent)
|
|
226
|
-
* - More reliable transfers with fewer timeouts
|
|
197
|
+
* Sanitize filename to prevent issues
|
|
227
198
|
*/
|
|
228
|
-
|
|
199
|
+
private sanitizeFilename;
|
|
229
200
|
/**
|
|
230
|
-
*
|
|
201
|
+
* Upload a large file using chunked upload for better reliability.
|
|
202
|
+
* Files >30MB are automatically chunked into 10MB parts and uploaded in parallel.
|
|
231
203
|
*
|
|
232
|
-
*
|
|
233
|
-
* -
|
|
234
|
-
*
|
|
204
|
+
* @param filePath - Path to the file to upload
|
|
205
|
+
* @param contentType - MIME type of the file
|
|
206
|
+
* @returns upload_id to use with conversion endpoints
|
|
235
207
|
*/
|
|
236
|
-
|
|
208
|
+
uploadFileChunked(filePath: string, contentType?: string): Promise<string>;
|
|
237
209
|
/**
|
|
238
|
-
*
|
|
210
|
+
* Get MIME type for a file based on extension
|
|
239
211
|
*/
|
|
240
|
-
|
|
241
|
-
supported: boolean;
|
|
242
|
-
reason: string;
|
|
243
|
-
}>;
|
|
212
|
+
private getMimeType;
|
|
244
213
|
/**
|
|
245
|
-
*
|
|
214
|
+
* Convert a file using a pre-uploaded upload_id (for files >30MB)
|
|
215
|
+
* This version uses chunked upload for better memory efficiency and reliability.
|
|
246
216
|
*/
|
|
247
|
-
|
|
217
|
+
convertFileFromUpload(uploadId: string, targetFormat: string, options?: ConversionOptions): Promise<ConversionResponse>;
|
|
248
218
|
/**
|
|
249
|
-
*
|
|
219
|
+
* Check if a file should use chunked upload based on size
|
|
250
220
|
*/
|
|
251
|
-
|
|
221
|
+
shouldUseChunkedUpload(fileSize: number): boolean;
|
|
252
222
|
}
|
|
253
223
|
//# sourceMappingURL=client.d.ts.map
|
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,EAKb,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|