mcp-image-uploader 1.0.1

package/AGENTS.md

@@ -0,0 +1,33 @@
+# AGENTS.md
+
+## 🤖 智能体辅助指南
+
+本文件旨在为使用该项目的 AI 智能体（如 Claude, ChatGPT, Gemini 等）提供上下文、最佳实践和任务执行建议。
+
+### 1. 项目核心定位
+`mcp-image-uploader` 是一个基于 Model Context Protocol (MCP) 的工具服务器，主要职责是：
+- **图片处理**: 智能压缩图片以减少存储和传输成本。
+- **图床上传**: 将本地或远程图片转换为可访问的静态 URL。
+
+### 2. 关键工具：`upload_image`
+AI 智能体在需要处理图片上传任务时，应优先使用此工具。
+
+#### 最佳实践建议：
+- **自动压缩（默认）**: 在大多数场景下，保持 `autoCompress: true`。这会根据图片类型和大小自动平衡清晰度与体积。
+- **格式转换**: 如果目标平台对图片格式有严格要求（如微信公众号建议使用 JPEG），请指定 `format` 参数。
+- **批量处理**: 如果用户提供了多个路径或 URL，应串行或并行调用多次 `upload_image`。
+
+### 3. 给 AI 智能体的交互规范
+当您（智能体）作为编码助手或自动化脚本使用此项目时，请遵循以下原则：
+
+- **链接返回**: 上传成功后，请始终以 Markdown 链接或图片语法返回给用户，方便直观预览：`![图片说明](URL)`。
+- **错误透明**: 如果上传失败，请务必返回具体的错误信息（如文件不存在、网络连接超时等），不要仅返回“上传失败”。
+- **统计信息**: 主动告知用户压缩的效果（原始大小 vs 压缩后大小），提升用户对工具价值的感知。
+
+### 4. 常见任务流
+- **“帮我上传这张图”**: 识别输入源（路径或链接） -> 调用 `upload_image` -> 返回预览链接。
+- **“图片太大发不出去”**: 解释可以使用此工具进行压缩 -> 调用 `upload_image` -> 返回压缩后的链接及比例。
+- **“把这个文件夹里的所有截图都上传”**: 扫描目录 -> 过滤图片文件 -> 循环上传。
+
+---
+*注：此文件是智能体与项目之间的协作桥梁，建议根据新功能的迭代持续更新。*

package/README.md

@@ -0,0 +1,173 @@
+# MCP Image Uploader
+
+一个用于图片智能压缩和上传的 Model Context Protocol (MCP) 服务器。
+
+## 功能特性
+
+- **多源输入**: 支持本地文件路径和远程 URL
+- **智能压缩**: 根据图片格式和大小自动应用最优压缩策略
+- **多格式支持**: JPEG、PNG、WebP、AVIF
+- **双运行时**: 支持 Node.js 和 Bun
+
+## 安装
+
+```bash
+# 使用 pnpm
+pnpm install
+
+# 构建
+pnpm build
+```
+
+## 使用方式
+
+### Claude Desktop 配置
+
+在 `~/Library/Application Support/Claude/claude_desktop_config.json` 中添加：
+
+```json
+{
+  "mcpServers": {
+    "image-uploader": {
+      "command": "node",
+      "args": [
+        "/path/to/mcp-image-uploader/dist/index.js",
+        "UPLOAD_ENDPOINT=https://your-api.com/upload"
+      ]
+    }
+  }
+}
+```
+
+或使用开发模式：
+
+```json
+{
+  "mcpServers": {
+    "image-uploader": {
+      "command": "npx",
+      "args": [
+        "tsx",
+        "/path/to/mcp-image-uploader/src/index.ts",
+        "UPLOAD_ENDPOINT=https://your-api.com/upload"
+      ]
+    }
+  }
+}
+```
+
+### Bun 运行时
+
+```json
+{
+  "mcpServers": {
+    "image-uploader": {
+      "command": "bun",
+      "args": [
+        "/path/to/mcp-image-uploader/src/index.ts",
+        "UPLOAD_ENDPOINT=https://your-api.com/upload"
+      ]
+    }
+  }
+}
+```
+
+### 配置参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `UPLOAD_ENDPOINT` | ✅ | 图片上传接口地址 |
+
+也可以通过环境变量配置：
+
+```bash
+UPLOAD_ENDPOINT=https://your-api.com/upload node dist/index.js
+```
+
+### 上传接口要求
+
+上传接口需要支持以下格式：
+
+**请求:**
+- Method: `POST`
+- Body: 图片文件 (File 对象)
+
+**响应:**
+```json
+{
+  "url": "https://cdn.example.com/path/to/image.jpg"
+}
+```
+
+**错误响应:**
+```json
+{
+  "dm_error": 10001,
+  "error_msg": "错误信息"
+}
+```
+
+## 工具说明
+
+### `upload_image`
+
+压缩并上传图片到图床。
+
+**参数:**
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `source` | string | (必填) | 图片来源：本地路径或远程 URL |
+| `skipCompress` | boolean | `false` | 是否跳过压缩，直接上传原图 |
+| `autoCompress` | boolean | `true` | 是否启用智能自动压缩（仅 skipCompress=false 时生效） |
+| `quality` | number | - | 手动压缩质量 (1-100)，仅 skipCompress=false 且 autoCompress=false 时生效 |
+| `format` | string | - | 输出格式：jpeg/png/webp/avif（默认保持原格式） |
+
+**返回:**
+
+```json
+{
+  "success": true,
+  "url": "https://...",
+  "stats": {
+    "originalSize": "1.5 MB",
+    "compressedSize": "320 KB",
+    "compressionRatio": "78%"
+  }
+}
+```
+
+## 压缩策略
+
+### JPEG
+- **自动**: < 500KB → quality=78 | > 2MB → quality=65 | 常规 → quality=72
+- **手动**: quality=85 (默认)
+
+### PNG
+- **自动**: 有损量化 + 动态压缩等级
+- **手动**: 无损压缩
+
+### WebP
+- **自动**: quality=75, alphaQuality=100
+- **手动**: 自定义 quality (默认 75)
+
+### AVIF
+- **自动**: 无损压缩
+- **手动**: quality=50 (默认)
+
+## 开发
+
+```bash
+# 开发模式
+pnpm dev
+
+# 构建
+pnpm build
+
+# 启动
+pnpm start
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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;
+}
+export declare function getConfig(): Config;
+/**
+ * 重置配置（仅用于测试）
+ */
+export declare function resetConfig(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,MAAM;IACnB,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;CACrB;AAmED,wBAAgB,SAAS,IAAI,MAAM,CAgBlC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/config.js

@@ -0,0 +1,89 @@
+/**
+ * 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
+ */
+/**
+ * 默认配置
+ */
+const DEFAULT_CONFIG = {
+    uploadUrl: '',
+};
+/**
+ * 解析命令行参数获取配置
+ */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const 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) {
+    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 = null;
+export function getConfig() {
+    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() {
+    cachedConfig = null;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH;;GAEG;AACH,MAAM,cAAc,GAAW;IAC3B,SAAS,EAAE,EAAE;CAChB,CAAC;AAEF;;GAEG;AACH,SAAS,SAAS;IACd,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,4BAA4B;QAC5B,IAAI,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrD,SAAS;QACb,CAAC;IACL,CAAC;IAED,WAAW;IACX,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QACnD,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,MAAc;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACtD,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;QAClF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACrC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,2FAA2F,CAAC,CAAC;QAC3G,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,YAAY;IACZ,IAAI,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC,MAAM,UAAU,SAAS;IACrB,IAAI,YAAY,EAAE,CAAC;QACf,OAAO,YAAY,CAAC;IACxB,CAAC;IAED,MAAM,UAAU,GAAG,SAAS,EAAE,CAAC;IAC/B,YAAY,GAAG;QACX,GAAG,cAAc;QACjB,GAAG,UAAU;KAChB,CAAC;IAEF,cAAc,CAAC,YAAY,CAAC,CAAC;IAE7B,OAAO,CAAC,KAAK,CAAC,gCAAgC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IAExE,OAAO,YAAY,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACvB,YAAY,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,59 @@
+#!/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',
+                    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',
+                    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);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,aAAa;AACb,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IACzB,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,OAAO;CACnB,CAAC,CAAC;AAEH,qBAAqB;AACrB,MAAM,CAAC,IAAI,CACP,cAAc,EACd,gDAAgD,EAChD,iBAAiB,CAAC,KAAK,EACvB,KAAK,EAAE,MAAM,EAAE,EAAE;IACb,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAEhD,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACjB,OAAO,EAAE,IAAI;wBACb,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,KAAK,EAAE;4BACH,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC;4BAC9C,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC;4BAClD,gBAAgB,EAAE,GAAG,MAAM,CAAC,gBAAgB,GAAG;yBAClD;qBACJ,EAAE,IAAI,EAAE,CAAC,CAAC;iBACd;aACJ;SACJ,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;QAEtC,OAAO;YACH,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACjB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,OAAO;qBACjB,EAAE,IAAI,EAAE,CAAC,CAAC;iBACd;aACJ;YACD,OAAO,EAAE,IAAI;SAChB,CAAC;IACN,CAAC;AACL,CAAC,CACJ,CAAC;AAEF,QAAQ;AACR,KAAK,UAAU,IAAI;IACf,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;AACrD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/services/compressor.d.ts

@@ -0,0 +1,10 @@
+import type { CompressionResult, CompressionOptions, ImageMetadata } from '../types/index.js';
+/**
+ * 获取图片元数据
+ */
+export declare function getImageMetadata(buffer: Buffer): Promise<ImageMetadata>;
+/**
+ * 压缩图片
+ */
+export declare function compressImage(buffer: Buffer, options: CompressionOptions): Promise<CompressionResult>;
+//# sourceMappingURL=compressor.d.ts.map

package/dist/services/compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressor.d.ts","sourceRoot":"","sources":["../../src/services/compressor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAe,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAM3G;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAS7E;AAmBD;;GAEG;AACH,wBAAsB,aAAa,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CA8B5B"}

package/dist/services/compressor.js

@@ -0,0 +1,64 @@
+import sharp from 'sharp';
+import { compressJpeg } from '../strategies/jpeg.js';
+import { compressPng } from '../strategies/png.js';
+import { compressWebp } from '../strategies/webp.js';
+import { compressAvif } from '../strategies/avif.js';
+/**
+ * 获取图片元数据
+ */
+export async function getImageMetadata(buffer) {
+    const metadata = await sharp(buffer).metadata();
+    return {
+        format: normalizeFormat(metadata.format),
+        width: metadata.width ?? 0,
+        height: metadata.height ?? 0,
+        size: buffer.length,
+    };
+}
+/**
+ * 标准化格式名称
+ */
+function normalizeFormat(format) {
+    const formatMap = {
+        'jpeg': 'jpeg',
+        'jpg': 'jpeg',
+        'png': 'png',
+        'webp': 'webp',
+        'avif': 'avif',
+        'gif': 'gif',
+        'tiff': 'tiff',
+    };
+    return formatMap[format?.toLowerCase() ?? ''] ?? 'jpeg';
+}
+/**
+ * 压缩图片
+ */
+export async function compressImage(buffer, options) {
+    const metadata = await getImageMetadata(buffer);
+    const targetFormat = options.format ?? metadata.format;
+    let compressedBuffer;
+    switch (targetFormat) {
+        case 'jpeg':
+            compressedBuffer = await compressJpeg(buffer, metadata.size, options);
+            break;
+        case 'png':
+            compressedBuffer = await compressPng(buffer, metadata.size, options);
+            break;
+        case 'webp':
+            compressedBuffer = await compressWebp(buffer, options);
+            break;
+        case 'avif':
+            compressedBuffer = await compressAvif(buffer, options);
+            break;
+        default:
+            // 对于不支持的格式，直接返回原始 buffer
+            compressedBuffer = buffer;
+    }
+    return {
+        buffer: compressedBuffer,
+        originalSize: metadata.size,
+        compressedSize: compressedBuffer.length,
+        format: targetFormat,
+    };
+}
+//# sourceMappingURL=compressor.js.map

package/dist/services/compressor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressor.js","sourceRoot":"","sources":["../../src/services/compressor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc;IACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAEhD,OAAO;QACH,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC;QACxC,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,CAAC;QAC1B,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,MAA0B;IAC/C,MAAM,SAAS,GAAgC;QAC3C,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,MAAM;KACjB,CAAC;IAEF,OAAO,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,MAAc,EACd,OAA2B;IAE3B,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;IAEvD,IAAI,gBAAwB,CAAC;IAE7B,QAAQ,YAAY,EAAE,CAAC;QACnB,KAAK,MAAM;YACP,gBAAgB,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACtE,MAAM;QACV,KAAK,KAAK;YACN,gBAAgB,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACrE,MAAM;QACV,KAAK,MAAM;YACP,gBAAgB,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM;QACV,KAAK,MAAM;YACP,gBAAgB,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM;QACV;YACI,yBAAyB;YACzB,gBAAgB,GAAG,MAAM,CAAC;IAClC,CAAC;IAED,OAAO;QACH,MAAM,EAAE,gBAAgB;QACxB,YAAY,EAAE,QAAQ,CAAC,IAAI;QAC3B,cAAc,EAAE,gBAAgB,CAAC,MAAM;QACvC,MAAM,EAAE,YAAY;KACvB,CAAC;AACN,CAAC"}

package/dist/services/image-loader.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 加载图片
+ * 支持本地文件路径和远程 URL
+ */
+export declare function loadImage(source: string): Promise<Buffer>;
+//# sourceMappingURL=image-loader.d.ts.map

package/dist/services/image-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-loader.d.ts","sourceRoot":"","sources":["../../src/services/image-loader.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM/D"}

package/dist/services/image-loader.js

@@ -0,0 +1,47 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { isUrl } from '../utils/index.js';
+/**
+ * 加载图片
+ * 支持本地文件路径和远程 URL
+ */
+export async function loadImage(source) {
+    if (isUrl(source)) {
+        return loadFromUrl(source);
+    }
+    else {
+        return loadFromFile(source);
+    }
+}
+/**
+ * 从本地文件加载
+ */
+async function loadFromFile(filePath) {
+    const absolutePath = path.isAbsolute(filePath)
+        ? filePath
+        : path.resolve(process.cwd(), filePath);
+    try {
+        const buffer = await fs.readFile(absolutePath);
+        return buffer;
+    }
+    catch (error) {
+        throw new Error(`无法读取文件: ${absolutePath} - ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * 从远程 URL 加载
+ */
+async function loadFromUrl(url) {
+    try {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    }
+    catch (error) {
+        throw new Error(`无法下载图片: ${url} - ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=image-loader.js.map

package/dist/services/image-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-loader.js","sourceRoot":"","sources":["../../src/services/image-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc;IAC1C,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACJ,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,QAAgB;IACxC,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC1C,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAE5C,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,WAAW,YAAY,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3G,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,WAAW,CAAC,GAAW;IAClC,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,WAAW,GAAG,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;AACL,CAAC"}

package/dist/services/uploader.d.ts

@@ -0,0 +1,6 @@
+import type { ImageFormat } from '../types/index.js';
+/**
+ * 上传图片到图床
+ */
+export declare function uploadImage(buffer: Buffer, format: ImageFormat): Promise<string>;
+//# sourceMappingURL=uploader.d.ts.map

package/dist/services/uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploader.d.ts","sourceRoot":"","sources":["../../src/services/uploader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmCrD;;GAEG;AACH,wBAAsB,WAAW,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,CA2CjB"}

package/dist/services/uploader.js

@@ -0,0 +1,65 @@
+import { getConfig } from '../config.js';
+/**
+ * 获取 MIME 类型
+ */
+function getMimeType(format) {
+    const mimeTypes = {
+        'jpeg': 'image/jpeg',
+        'png': 'image/png',
+        'webp': 'image/webp',
+        'avif': 'image/avif',
+        'gif': 'image/gif',
+        'tiff': 'image/tiff',
+    };
+    return mimeTypes[format] ?? 'application/octet-stream';
+}
+/**
+ * 生成文件名
+ */
+function generateFilename(format) {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).substring(2, 8);
+    const extension = format === 'jpeg' ? 'jpg' : format;
+    return `image_${timestamp}_${random}.${extension}`;
+}
+/**
+ * 上传图片到图床
+ */
+export async function uploadImage(buffer, format) {
+    const filename = generateFilename(format);
+    const mimeType = getMimeType(format);
+    console.error(`[MCP] 准备上传: ${filename}, MIME: ${mimeType}, 大小: ${buffer.length} bytes`);
+    // 创建 FormData - 使用 File 对象确保正确的 MIME 类型
+    // 在 Node.js/Bun 中使用 File 对象
+    const file = new File([buffer], filename, { type: mimeType });
+    try {
+        const { uploadUrl } = getConfig();
+        const response = await fetch(uploadUrl, {
+            method: 'POST',
+            body: file,
+        });
+        const responseText = await response.text();
+        console.error(`[MCP] 上传响应: ${responseText}`);
+        let result;
+        try {
+            result = JSON.parse(responseText);
+        }
+        catch {
+            throw new Error(`上传响应解析失败: ${responseText}`);
+        }
+        if (result.dm_error) {
+            throw new Error(`上传失败 (${result.dm_error}): ${result.error_msg ?? '未知错误'}`);
+        }
+        if (!result.url) {
+            throw new Error(`上传响应缺少 url 字段: ${responseText}`);
+        }
+        return result.url;
+    }
+    catch (error) {
+        if (error instanceof Error && (error.message.startsWith('上传') || error.message.includes('dm_error'))) {
+            throw error;
+        }
+        throw new Error(`上传请求失败: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=uploader.js.map

package/dist/services/uploader.js.map

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

package/dist/strategies/avif.d.ts

@@ -0,0 +1,9 @@
+import type { CompressionOptions } from '../types/index.js';
+/**
+ * AVIF 压缩策略
+ *
+ * 自动模式：lossless=true (无损)
+ * 手动模式：使用指定 quality（默认 50）
+ */
+export declare function compressAvif(buffer: Buffer, options: CompressionOptions): Promise<Buffer>;
+//# sourceMappingURL=avif.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"avif.d.ts","sourceRoot":"","sources":["../../src/strategies/avif.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,CAmBjB"}