mcp-image-uploader 1.0.1

package/dist/strategies/avif.js

@@ -0,0 +1,29 @@
+import sharp from 'sharp';
+/**
+ * AVIF 压缩策略
+ *
+ * 自动模式：lossless=true (无损)
+ * 手动模式：使用指定 quality（默认 50）
+ */
+export async function compressAvif(buffer, options) {
+    if (options.autoCompress) {
+        // 自动模式：无损压缩
+        return sharp(buffer)
+            .avif({
+            lossless: true,
+            effort: 6,
+        })
+            .toBuffer();
+    }
+    else {
+        // 手动模式
+        const quality = options.quality ?? 50;
+        return sharp(buffer)
+            .avif({
+            quality,
+            effort: 4,
+        })
+            .toBuffer();
+    }
+}
+//# sourceMappingURL=avif.js.map

package/dist/strategies/avif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avif.js","sourceRoot":"","sources":["../../src/strategies/avif.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,MAAc,EACd,OAA2B;IAE3B,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACvB,YAAY;QACZ,OAAO,KAAK,CAAC,MAAM,CAAC;aACf,IAAI,CAAC;YACF,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,CAAC;SACZ,CAAC;aACD,QAAQ,EAAE,CAAC;IACpB,CAAC;SAAM,CAAC;QACJ,OAAO;QACP,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,MAAM,CAAC;aACf,IAAI,CAAC;YACF,OAAO;YACP,MAAM,EAAE,CAAC;SACZ,CAAC;aACD,QAAQ,EAAE,CAAC;IACpB,CAAC;AACL,CAAC"}

package/dist/strategies/jpeg.d.ts

@@ -0,0 +1,13 @@
+import type { CompressionOptions } from '../types/index.js';
+/**
+ * JPEG 压缩策略
+ *
+ * 自动模式：
+ * - < 500KB → quality=78 + mozjpeg 优化
+ * - > 2MB → quality=65 + mozjpeg 优化
+ * - 常规 → quality=72 + mozjpeg 优化
+ *
+ * 手动模式：使用指定 quality（默认 85）
+ */
+export declare function compressJpeg(buffer: Buffer, originalSize: number, options: CompressionOptions): Promise<Buffer>;
+//# sourceMappingURL=jpeg.d.ts.map

package/dist/strategies/jpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jpeg.d.ts","sourceRoot":"","sources":["../../src/strategies/jpeg.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAC9B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA0BjB"}

package/dist/strategies/jpeg.js

@@ -0,0 +1,40 @@
+import sharp from 'sharp';
+/**
+ * JPEG 压缩策略
+ *
+ * 自动模式：
+ * - < 500KB → quality=78 + mozjpeg 优化
+ * - > 2MB → quality=65 + mozjpeg 优化
+ * - 常规 → quality=72 + mozjpeg 优化
+ *
+ * 手动模式：使用指定 quality（默认 85）
+ */
+export async function compressJpeg(buffer, originalSize, options) {
+    let quality;
+    if (options.autoCompress) {
+        // 自动模式：根据文件大小选择质量
+        if (originalSize < 500 * 1024) {
+            // < 500KB：较高质量
+            quality = 78;
+        }
+        else if (originalSize > 2 * 1024 * 1024) {
+            // > 2MB：较低质量以获得更好压缩
+            quality = 65;
+        }
+        else {
+            // 常规区间
+            quality = 72;
+        }
+    }
+    else {
+        // 手动模式
+        quality = options.quality ?? 85;
+    }
+    return sharp(buffer)
+        .jpeg({
+        quality,
+        mozjpeg: true, // 使用 mozjpeg 高级优化
+    })
+        .toBuffer();
+}
+//# sourceMappingURL=jpeg.js.map

package/dist/strategies/jpeg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jpeg.js","sourceRoot":"","sources":["../../src/strategies/jpeg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,MAAc,EACd,YAAoB,EACpB,OAA2B;IAE3B,IAAI,OAAe,CAAC;IAEpB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACvB,kBAAkB;QAClB,IAAI,YAAY,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC;YAC5B,eAAe;YACf,OAAO,GAAG,EAAE,CAAC;QACjB,CAAC;aAAM,IAAI,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YACxC,oBAAoB;YACpB,OAAO,GAAG,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACJ,OAAO;YACP,OAAO,GAAG,EAAE,CAAC;QACjB,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,OAAO;QACP,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,CAAC;SACf,IAAI,CAAC;QACF,OAAO;QACP,OAAO,EAAE,IAAI,EAAE,kBAAkB;KACpC,CAAC;SACD,QAAQ,EAAE,CAAC;AACpB,CAAC"}

package/dist/strategies/png.d.ts

@@ -0,0 +1,12 @@
+import type { CompressionOptions } from '../types/index.js';
+/**
+ * PNG 压缩策略
+ *
+ * 自动模式：
+ * - 有损量化: palette=true, quality 65-95
+ * - 压缩等级根据文件大小动态调整
+ *
+ * 手动模式：无损压缩 + 高压缩等级
+ */
+export declare function compressPng(buffer: Buffer, originalSize: number, options: CompressionOptions): Promise<Buffer>;
+//# sourceMappingURL=png.d.ts.map

package/dist/strategies/png.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"png.d.ts","sourceRoot":"","sources":["../../src/strategies/png.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC7B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAsCjB"}

package/dist/strategies/png.js

@@ -0,0 +1,51 @@
+import sharp from 'sharp';
+/**
+ * PNG 压缩策略
+ *
+ * 自动模式：
+ * - 有损量化: palette=true, quality 65-95
+ * - 压缩等级根据文件大小动态调整
+ *
+ * 手动模式：无损压缩 + 高压缩等级
+ */
+export async function compressPng(buffer, originalSize, options) {
+    if (options.autoCompress) {
+        // 自动模式：使用有损量化
+        // 根据文件大小选择压缩等级
+        let compressionLevel;
+        let quality;
+        if (originalSize > 2 * 1024 * 1024) {
+            // > 2MB：更激进的压缩
+            compressionLevel = 9;
+            quality = 65;
+        }
+        else if (originalSize > 500 * 1024) {
+            // 500KB - 2MB
+            compressionLevel = 8;
+            quality = 75;
+        }
+        else {
+            // < 500KB
+            compressionLevel = 6;
+            quality = 85;
+        }
+        return sharp(buffer)
+            .png({
+            palette: true, // 启用量化 (24位 → 8位)
+            quality, // 量化质量
+            compressionLevel,
+            effort: 7, // 优化努力程度
+        })
+            .toBuffer();
+    }
+    else {
+        // 手动模式：无损压缩
+        return sharp(buffer)
+            .png({
+            compressionLevel: 9,
+            effort: 10,
+        })
+            .toBuffer();
+    }
+}
+//# sourceMappingURL=png.js.map

package/dist/strategies/png.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"png.js","sourceRoot":"","sources":["../../src/strategies/png.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC7B,MAAc,EACd,YAAoB,EACpB,OAA2B;IAE3B,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACvB,cAAc;QACd,eAAe;QACf,IAAI,gBAAwB,CAAC;QAC7B,IAAI,OAAe,CAAC;QAEpB,IAAI,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YACjC,eAAe;YACf,gBAAgB,GAAG,CAAC,CAAC;YACrB,OAAO,GAAG,EAAE,CAAC;QACjB,CAAC;aAAM,IAAI,YAAY,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC;YACnC,cAAc;YACd,gBAAgB,GAAG,CAAC,CAAC;YACrB,OAAO,GAAG,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACJ,UAAU;YACV,gBAAgB,GAAG,CAAC,CAAC;YACrB,OAAO,GAAG,EAAE,CAAC;QACjB,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,CAAC;aACf,GAAG,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,kBAAkB;YACjC,OAAO,EAAQ,OAAO;YACtB,gBAAgB;YAChB,MAAM,EAAE,CAAC,EAAM,SAAS;SAC3B,CAAC;aACD,QAAQ,EAAE,CAAC;IACpB,CAAC;SAAM,CAAC;QACJ,YAAY;QACZ,OAAO,KAAK,CAAC,MAAM,CAAC;aACf,GAAG,CAAC;YACD,gBAAgB,EAAE,CAAC;YACnB,MAAM,EAAE,EAAE;SACb,CAAC;aACD,QAAQ,EAAE,CAAC;IACpB,CAAC;AACL,CAAC"}

package/dist/strategies/webp.d.ts

@@ -0,0 +1,9 @@
+import type { CompressionOptions } from '../types/index.js';
+/**
+ * WebP 压缩策略
+ *
+ * 自动模式：quality=75, alphaQuality=100, effort=4
+ * 手动模式：使用指定 quality（默认 75）
+ */
+export declare function compressWebp(buffer: Buffer, options: CompressionOptions): Promise<Buffer>;
+//# sourceMappingURL=webp.d.ts.map

package/dist/strategies/webp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webp.d.ts","sourceRoot":"","sources":["../../src/strategies/webp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;GAKG;AACH,wBAAsB,YAAY,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/strategies/webp.js

@@ -0,0 +1,19 @@
+import sharp from 'sharp';
+/**
+ * WebP 压缩策略
+ *
+ * 自动模式：quality=75, alphaQuality=100, effort=4
+ * 手动模式：使用指定 quality（默认 75）
+ */
+export async function compressWebp(buffer, options) {
+    const quality = options.autoCompress ? 75 : (options.quality ?? 75);
+    return sharp(buffer)
+        .webp({
+        quality,
+        alphaQuality: 100, // 保持 alpha 通道质量
+        effort: options.autoCompress ? 4 : 6,
+        smartSubsample: true, // 智能子采样
+    })
+        .toBuffer();
+}
+//# sourceMappingURL=webp.js.map

package/dist/strategies/webp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webp.js","sourceRoot":"","sources":["../../src/strategies/webp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,MAAc,EACd,OAA2B;IAE3B,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAEpE,OAAO,KAAK,CAAC,MAAM,CAAC;SACf,IAAI,CAAC;QACF,OAAO;QACP,YAAY,EAAE,GAAG,EAAE,gBAAgB;QACnC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,cAAc,EAAE,IAAI,EAAE,QAAQ;KACjC,CAAC;SACD,QAAQ,EAAE,CAAC;AACpB,CAAC"}

package/dist/tools/upload-image.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import type { UploadResult } from '../types/index.js';
+/**
+ * 上传图片工具的参数 Schema
+ */
+export declare const uploadImageSchema: z.ZodObject<{
+    source: z.ZodString;
+    skipCompress: z.ZodDefault<z.ZodBoolean>;
+    autoCompress: z.ZodDefault<z.ZodBoolean>;
+    quality: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodOptional<z.ZodEnum<["jpeg", "png", "webp", "avif"]>>;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    skipCompress: boolean;
+    autoCompress: boolean;
+    quality?: number | undefined;
+    format?: "jpeg" | "png" | "webp" | "avif" | undefined;
+}, {
+    source: string;
+    quality?: number | undefined;
+    format?: "jpeg" | "png" | "webp" | "avif" | undefined;
+    skipCompress?: boolean | undefined;
+    autoCompress?: boolean | undefined;
+}>;
+export type UploadImageParams = z.infer<typeof uploadImageSchema>;
+/**
+ * 执行图片上传
+ */
+export declare function executeUploadImage(params: UploadImageParams): Promise<UploadResult>;
+//# sourceMappingURL=upload-image.d.ts.map

package/dist/tools/upload-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-image.d.ts","sourceRoot":"","sources":["../../src/tools/upload-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAsB5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAsB,kBAAkB,CACpC,MAAM,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAyDvB"}

package/dist/tools/upload-image.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+import { loadImage } from '../services/image-loader.js';
+import { compressImage, getImageMetadata } from '../services/compressor.js';
+import { uploadImage } from '../services/uploader.js';
+import { formatBytes, calculateCompressionRatio } from '../utils/index.js';
+/**
+ * 上传图片工具的参数 Schema
+ */
+export const uploadImageSchema = z.object({
+    source: z
+        .string()
+        .describe('图片来源：本地文件路径或远程 URL'),
+    skipCompress: z
+        .boolean()
+        .default(false)
+        .describe('是否跳过压缩，直接上传原图（默认关闭）'),
+    autoCompress: z
+        .boolean()
+        .default(true)
+        .describe('是否启用智能自动压缩（默认开启），仅在 skipCompress=false 时生效'),
+    quality: z
+        .number()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe('手动压缩质量 (1-100)，仅在 skipCompress=false 且 autoCompress=false 时生效'),
+    format: z
+        .enum(['jpeg', 'png', 'webp', 'avif'])
+        .optional()
+        .describe('输出格式（可选，默认保持原格式）'),
+});
+/**
+ * 执行图片上传
+ */
+export async function executeUploadImage(params) {
+    const { source, skipCompress, autoCompress, quality, format } = params;
+    // 1. 加载图片
+    console.error(`[MCP] 正在加载图片: ${source}`);
+    const imageBuffer = await loadImage(source);
+    console.error(`[MCP] 图片已加载: ${formatBytes(imageBuffer.length)}`);
+    let finalBuffer;
+    let originalSize;
+    let compressedSize;
+    let imageFormat;
+    if (skipCompress) {
+        // 跳过压缩，直接使用原图
+        console.error(`[MCP] 跳过压缩，使用原图上传`);
+        const metadata = await getImageMetadata(imageBuffer);
+        finalBuffer = imageBuffer;
+        originalSize = imageBuffer.length;
+        compressedSize = imageBuffer.length;
+        imageFormat = format ?? metadata.format;
+    }
+    else {
+        // 2. 压缩图片
+        console.error(`[MCP] 正在压缩图片 (autoCompress=${autoCompress})`);
+        const compressionResult = await compressImage(imageBuffer, {
+            autoCompress,
+            quality,
+            format: format,
+        });
+        const ratio = calculateCompressionRatio(compressionResult.originalSize, compressionResult.compressedSize);
+        console.error(`[MCP] 压缩完成: ${formatBytes(compressionResult.originalSize)} → ${formatBytes(compressionResult.compressedSize)} (${ratio}%)`);
+        finalBuffer = compressionResult.buffer;
+        originalSize = compressionResult.originalSize;
+        compressedSize = compressionResult.compressedSize;
+        imageFormat = compressionResult.format;
+    }
+    // 3. 上传图片
+    console.error(`[MCP] 正在上传图片...`);
+    const url = await uploadImage(finalBuffer, imageFormat);
+    console.error(`[MCP] 上传成功: ${url}`);
+    const ratio = calculateCompressionRatio(originalSize, compressedSize);
+    return {
+        url,
+        originalSize,
+        compressedSize,
+        compressionRatio: ratio,
+    };
+}
+//# sourceMappingURL=upload-image.js.map

package/dist/tools/upload-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-image.js","sourceRoot":"","sources":["../../src/tools/upload-image.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 支持的图片格式
+ */
+export type ImageFormat = 'jpeg' | 'png' | 'webp' | 'avif' | 'gif' | 'tiff';
+/**
+ * 压缩选项
+ */
+export interface CompressionOptions {
+    /** 是否启用自动压缩 */
+    autoCompress: boolean;
+    /** 手动压缩质量 (1-100) */
+    quality?: number;
+    /** 输出格式 */
+    format?: ImageFormat;
+}
+/**
+ * 图片元数据
+ */
+export interface ImageMetadata {
+    format: ImageFormat;
+    width: number;
+    height: number;
+    size: number;
+}
+/**
+ * 压缩结果
+ */
+export interface CompressionResult {
+    buffer: Buffer;
+    originalSize: number;
+    compressedSize: number;
+    format: ImageFormat;
+}
+/**
+ * 上传结果
+ */
+export interface UploadResult {
+    url: string;
+    originalSize: number;
+    compressedSize: number;
+    compressionRatio: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,eAAe;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 判断是否为 URL
+ */
+export declare function isUrl(input: string): boolean;
+/**
+ * 格式化文件大小
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * 计算压缩比
+ */
+export declare function calculateCompressionRatio(original: number, compressed: number): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO5C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGtF"}

package/dist/utils/index.js

@@ -0,0 +1,32 @@
+/**
+ * 判断是否为 URL
+ */
+export function isUrl(input) {
+    try {
+        const url = new URL(input);
+        return url.protocol === 'http:' || url.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 格式化文件大小
+ */
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
+}
+/**
+ * 计算压缩比
+ */
+export function calculateCompressionRatio(original, compressed) {
+    if (original === 0)
+        return 0;
+    return Math.round((1 - compressed / original) * 100);
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IAC/B,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACrC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC;IACf,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,UAAkB;IAC1E,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC;AACzD,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "mcp-image-uploader",
+  "version": "1.0.1",
+  "description": "MCP server for image compression and upload",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-image-uploader": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "start:bun": "bun src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "image",
+    "compression",
+    "upload"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "sharp": "^0.33.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/config.ts

@@ -0,0 +1,106 @@
+/**
+ * MCP Image Uploader 配置模块
+ * 
+ * 支持通过命令行参数配置上传接口地址，实现业务解耦
+ * 
+ * 使用方式（命令行参数）：
+ *   node dist/index.js UPLOAD_ENDPOINT=https://your-api.com/upload
+ * 
+ * 使用方式（环境变量）：
+ *   UPLOAD_ENDPOINT=https://your-api.com/upload node dist/index.js
+ */
+
+export interface Config {
+    /** 上传接口地址 */
+    uploadUrl: string;
+}
+
+/**
+ * 默认配置
+ */
+const DEFAULT_CONFIG: Config = {
+    uploadUrl: '',
+};
+
+/**
+ * 解析命令行参数获取配置
+ */
+function parseArgs(): Partial<Config> {
+    const args = process.argv.slice(2);
+    const config: Partial<Config> = {};
+
+    for (const arg of args) {
+        // 支持 UPLOAD_ENDPOINT=xxx 格式
+        if (arg.startsWith('UPLOAD_ENDPOINT=')) {
+            config.uploadUrl = arg.split('=').slice(1).join('=');
+            continue;
+        }
+    }
+
+    // 同时支持环境变量
+    if (!config.uploadUrl && process.env.UPLOAD_ENDPOINT) {
+        config.uploadUrl = process.env.UPLOAD_ENDPOINT;
+    }
+
+    return config;
+}
+
+/**
+ * 验证配置
+ */
+function validateConfig(config: Config): void {
+    if (!config.uploadUrl) {
+        console.error('[MCP] 错误: 必须配置上传接口地址 UPLOAD_ENDPOINT');
+        console.error('[MCP] 使用方式:');
+        console.error('  node dist/index.js UPLOAD_ENDPOINT=https://your-api.com/upload');
+        console.error('');
+        console.error('[MCP] MCP 配置示例:');
+        console.error('  {');
+        console.error('    "mcpServers": {');
+        console.error('      "image-uploader": {');
+        console.error('        "command": "node",');
+        console.error('        "args": ["/path/to/dist/index.js", "UPLOAD_ENDPOINT=https://your-api.com/upload"]');
+        console.error('      }');
+        console.error('    }');
+        console.error('  }');
+        process.exit(1);
+    }
+
+    // 验证 URL 格式
+    try {
+        new URL(config.uploadUrl);
+    } catch {
+        console.error(`[MCP] 错误: 无效的上传接口地址: ${config.uploadUrl}`);
+        process.exit(1);
+    }
+}
+
+/**
+ * 获取配置（单例）
+ */
+let cachedConfig: Config | null = null;
+
+export function getConfig(): Config {
+    if (cachedConfig) {
+        return cachedConfig;
+    }
+
+    const parsedArgs = parseArgs();
+    cachedConfig = {
+        ...DEFAULT_CONFIG,
+        ...parsedArgs,
+    };
+
+    validateConfig(cachedConfig);
+
+    console.error(`[MCP] 配置已加载: UPLOAD_ENDPOINT=${cachedConfig.uploadUrl}`);
+
+    return cachedConfig;
+}
+
+/**
+ * 重置配置（仅用于测试）
+ */
+export function resetConfig(): void {
+    cachedConfig = null;
+}

package/src/index.ts

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { uploadImageSchema, executeUploadImage } from './tools/upload-image.js';
+import { formatBytes } from './utils/index.js';
+
+// 创建 MCP 服务器
+const server = new McpServer({
+    name: 'mcp-image-uploader',
+    version: '1.0.0',
+});
+
+// 注册 upload_image 工具
+server.tool(
+    'upload_image',
+    '压缩并上传图片到图床。支持本地文件路径或远程 URL 作为输入，智能压缩后返回图床 URL。',
+    uploadImageSchema.shape,
+    async (params) => {
+        try {
+            const result = await executeUploadImage(params);
+
+            return {
+                content: [
+                    {
+                        type: 'text' as const,
+                        text: JSON.stringify({
+                            success: true,
+                            url: result.url,
+                            stats: {
+                                originalSize: formatBytes(result.originalSize),
+                                compressedSize: formatBytes(result.compressedSize),
+                                compressionRatio: `${result.compressionRatio}%`,
+                            },
+                        }, null, 2),
+                    },
+                ],
+            };
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`[MCP] 错误: ${message}`);
+
+            return {
+                content: [
+                    {
+                        type: 'text' as const,
+                        text: JSON.stringify({
+                            success: false,
+                            error: message,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+);
+
+// 启动服务器
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[MCP] Image Uploader Server 已启动');
+}
+
+main().catch((error) => {
+    console.error('[MCP] 服务器启动失败:', error);
+    process.exit(1);
+});