npm - @fluxpool/mcp-server - Versions diffs - 0.1.0 → 0.2.0 - Mend

@fluxpool/mcp-server 0.1.0 → 0.2.0

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.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -1,5 +1,8 @@
 # @fluxpool/mcp-server
+[![npm](https://img.shields.io/npm/v/@fluxpool/mcp-server)](https://www.npmjs.com/package/@fluxpool/mcp-server)
+[![license](https://img.shields.io/npm/l/@fluxpool/mcp-server)](LICENSE)
 Generate images and videos with [Fluxpool.ai](https://fluxpool.ai) from Claude,
 Cursor, or any MCP client — across Flux, Seedream, Seedance, Runway and more,
 billed against a single pool of Fluxpool credits.
@@ -19,6 +22,46 @@ Generation is **asynchronous**: `create_generation` returns an ID, then
 `check_generation` is polled until the status is `completed`. Output URLs are
 presigned and **expire after one hour** — download promptly.
+## Reference inputs (image / video / audio)
+`create_generation` accepts an `inputs` array for image-to-image, video-to-video
+and other reference-conditioned models. Every entry has the same shape:
+```json
+{ "type": "image", "source": "url",   "value": "https://..." }
+{ "type": "image", "source": "data",  "value": "data:image/png;base64,..." }
+{ "type": "image", "source": "local", "value": "./pic.png" }
+```
+- **`type`** — `image`, `video`, or `audio`.
+- **`source`** — how `value` should be interpreted:
+  - `url`   — an https:// URL, passed through untouched.
+  - `data`  — a base64 data-URI; the backend uploads it to S3 for you.
+  - `local` — a path on the machine running this bridge. Resolved locally
+              (see below) before being forwarded to the server.
+### Local file paths
+`source: "local"` is a bridge convenience: the file is read on your machine,
+base64-encoded, and sent to the server as a `data` entry. **The hosted
+endpoint never sees a `local` from this bridge**, so `local` works only when
+you connect via this package (not via the direct HTTP endpoint).
+**Auto-compression for oversize images.** The backend caps inline data-URIs
+at ~4.5 MB decoded. Images larger than 4 MB are automatically resized to
+2048px and re-encoded as webp. That path uses the optional
+[`sharp`](https://sharp.pixelplumbing.com/) dependency:
+```bash
+# From your MCP client machine — installs prebuilt binaries for your platform.
+npm install -g sharp
+```
+If `sharp` is not installed, oversize images are rejected with a message
+pointing you here. Video and audio files above 4 MB are never auto-compressed
+— use the two-step [`POST /v1/uploads`](https://api.fluxpool.ai) flow and pass
+the returned URL with `source: "url"`.
 ## Get an API key
 Create one at **<https://app.fluxpool.ai/api>**. Keys look like `fp_live_…`.
@@ -200,19 +243,26 @@ Tests stub `fetch` and use a dummy key — they never touch the network.
 ### Releasing
+See [PUBLISHING.md](PUBLISHING.md) for the full release process. Short
+version:
 ```bash
-npm version patch && git push --follow-tags
+npm publish --dry-run --access public   # check the file list and warnings
+npm version patch
+npm publish --access public --otp=<code>
+git push --follow-tags
 ```
-CI builds, tests, checks the tag matches `package.json`, and publishes via
-npm Trusted Publishing (OIDC) — no npm token is stored in this repo.
-## Contributing
+## Support
-Issues and pull requests: <https://github.com/ZKcandy/fluxpool-mcp-server/issues>
+Questions, bugs, or a tool you wish existed: email
+<dev@fluxpool.ai>, open an issue at
+<https://github.com/ZKcandy/fluxpool-mcp-server/issues>, or reach us through
+<https://fluxpool.ai>.
 Because tools are defined server-side, adding or changing one is a backend
-change rather than a change here. Open an issue describing the tool you need.
+change rather than a change to this package — new tools reach you without
+upgrading anything.
 ## License

package/dist/bridge.d.ts CHANGED Viewed

@@ -14,12 +14,15 @@
  */
 import type { Readable, Writable } from 'node:stream';
 import { type FluxpoolClient } from './client.js';
+import { type ResolveOptions } from './localInputs.js';
 export interface BridgeOptions {
     client: FluxpoolClient;
     input?: Readable;
     output?: Writable;
     /** Defaults to stderr. Never stdout — that channel is the protocol. */
     log?: (message: string) => void;
+    /** Injection seams for local-input resolution — tests only. */
+    resolveOptions?: ResolveOptions;
 }
 export declare class Bridge {
     #private;

package/dist/bridge.js CHANGED Viewed

@@ -14,17 +14,20 @@
  */
 import { createInterface } from 'node:readline';
 import { errorResponse } from './client.js';
+import { needsLocalResolution, resolveLocalInputs } from './localInputs.js';
 import { JSON_RPC } from './types.js';
 export class Bridge {
     #client;
     #input;
     #output;
     #log;
+    #resolveOptions;
     constructor(options) {
         this.#client = options.client;
         this.#input = options.input ?? process.stdin;
         this.#output = options.output ?? process.stdout;
         this.#log = options.log ?? ((message) => process.stderr.write(`${message}\n`));
+        this.#resolveOptions = options.resolveOptions;
     }
     /** Pump stdin until it closes. Resolves when the stream ends. */
     async run() {
@@ -55,6 +58,27 @@ export class Bridge {
             return;
         }
         const id = extractId(message);
+        // Local-file resolution runs BEFORE forwarding. It only fires when the
+        // message is a `tools/call` for `create_generation` and its arguments
+        // carry at least one `source: 'local'` entry — every other message
+        // (initialize, tools/list, check_generation, url/data inputs) skips
+        // straight through. Failures here become an INVALID_PARAMS response
+        // so the model on the other end gets a specific "your file didn't
+        // work" hint rather than a generic transport error.
+        if (needsLocalResolution(message)) {
+            try {
+                const params = message.params;
+                if (params && typeof params === 'object') {
+                    params.arguments = await resolveLocalInputs(params.arguments, this.#resolveOptions);
+                }
+            }
+            catch (cause) {
+                if (id === null)
+                    return;
+                this.write(errorResponse(id, JSON_RPC.INVALID_PARAMS, describe(cause)));
+                return;
+            }
+        }
         let response;
         try {
             response = await this.#client.send(message, id);

package/dist/bridge.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAiD,MAAM,YAAY,CAAC;~~AAUrF~~,MAAM,OAAO,MAAM;IACR,OAAO,CAAiB;IACxB,MAAM,CAAW;IACjB,OAAO,CAAW;IAClB,IAAI,CAA4B;~~IAEzC~~,YAAY,OAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC;~~IACjF~~,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,GAAG;QACP,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE3E,qEAAqE;QACrE,uEAAuE;QACvE,qEAAqE;QACrE,0DAA0D;QAC1D,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,uEAAuE;QACvE,4DAA4D;QAC5D,IAAI,OAAO,KAAK,EAAE;YAAE,OAAO;QAE3B,IAAI,OAAgB,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;YACrE,WAAW;YACX,IAAI,CAAC,KAAK,CACR,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,WAAW,EAAE,kDAAkD,CAAC,CAC9F,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,QAAyB,CAAC;QAC9B,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAoB,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mEAAmE;YACnE,uEAAuE;YACvE,qDAAqD;YACrD,IAAI,CAAC,IAAI,CAAC,2CAA2C,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACxE,IAAI,EAAE,KAAK,IAAI;gBAAE,OAAO;YACxB,QAAQ,GAAG,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,cAAc,EAAE,iBAAiB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5F,CAAC;QAED,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,CAAC,6BAA6B;QAC5D,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,OAAiB;QACzB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAEO,KAAK,CAAC,OAAiB;QAC7B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,OAAgB;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjE,MAAM,EAAE,GAAI,OAA4B,CAAC,EAAE,CAAC;IAC5C,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAChE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}
1	+ {"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}

package/dist/localInputs.d.ts ADDED Viewed

@@ -0,0 +1,70 @@
+/**
+ * Local-path resolution for `create_generation` inputs.
+ *
+ * The backend contract (project_api_image_input_unification) accepts three
+ * input sources:
+ *   - `url`   — https:// pass-through
+ *   - `data`  — base64 data-URI, backend inline-uploads to S3
+ *   - `local` — client-side ONLY; the Lambda has no way to reach a caller's
+ *               disk, so it rejects source=local with a 400.
+ *
+ * This module fills that gap for stdio MCP callers: when a `tools/call`
+ * message names a local file in `inputs[]`, we read it here, base64-encode
+ * (with optional sharp compression for oversize images), and rewrite the
+ * item to `source: 'data'` BEFORE the bridge forwards the request. The
+ * server never sees a `local` from this client.
+ *
+ * `sharp` is an optional dependency. If it is installed and an image
+ * exceeds the 4 MB data-URI target, we auto-resize + re-encode as webp
+ * so it fits. If not installed, oversize images get a clear error telling
+ * the user how to enable auto-compression. Non-image types (video/audio)
+ * never touch sharp regardless.
+ */
+export interface InputItem {
+    type?: string;
+    source?: string;
+    value?: string;
+    [k: string]: unknown;
+}
+export interface ResolveOptions {
+    /** Injection seam for tests — defaults to Node's fs.readFile. */
+    readFile?: (path: string) => Promise<Buffer>;
+    /** Injection seam for tests — defaults to dynamic import('sharp'). */
+    loadSharp?: () => Promise<SharpModule | null>;
+}
+interface SharpModule {
+    default: SharpFactory;
+}
+interface SharpFactory {
+    (input: Buffer): SharpInstance;
+}
+interface SharpInstance {
+    rotate(): SharpInstance;
+    resize(options: {
+        width?: number;
+        height?: number;
+        fit?: 'inside' | 'cover' | 'contain';
+        withoutEnlargement?: boolean;
+    }): SharpInstance;
+    webp(options: {
+        quality: number;
+    }): SharpInstance;
+    toBuffer(): Promise<Buffer>;
+}
+/**
+ * Walk a params object, rewriting every {source:'local'} entry inside
+ * `inputs[]` to {source:'data'}. Mutates in place and returns it so
+ * callers can chain.
+ *
+ * Throws with a plain Error whose message the bridge relays back to the
+ * MCP client as a JSON-RPC error. The message is written for the human
+ * on the other end of the client, not for a machine.
+ */
+export declare function resolveLocalInputs(params: unknown, options?: ResolveOptions): Promise<unknown>;
+/**
+ * True when the message is a `tools/call` for `create_generation` that
+ * has `inputs[]` with at least one `source: 'local'` entry. Cheap check
+ * used by the bridge to decide whether to run the resolver.
+ */
+export declare function needsLocalResolution(message: unknown): boolean;
+export {};

package/dist/localInputs.js ADDED Viewed

@@ -0,0 +1,200 @@
+/**
+ * Local-path resolution for `create_generation` inputs.
+ *
+ * The backend contract (project_api_image_input_unification) accepts three
+ * input sources:
+ *   - `url`   — https:// pass-through
+ *   - `data`  — base64 data-URI, backend inline-uploads to S3
+ *   - `local` — client-side ONLY; the Lambda has no way to reach a caller's
+ *               disk, so it rejects source=local with a 400.
+ *
+ * This module fills that gap for stdio MCP callers: when a `tools/call`
+ * message names a local file in `inputs[]`, we read it here, base64-encode
+ * (with optional sharp compression for oversize images), and rewrite the
+ * item to `source: 'data'` BEFORE the bridge forwards the request. The
+ * server never sees a `local` from this client.
+ *
+ * `sharp` is an optional dependency. If it is installed and an image
+ * exceeds the 4 MB data-URI target, we auto-resize + re-encode as webp
+ * so it fits. If not installed, oversize images get a clear error telling
+ * the user how to enable auto-compression. Non-image types (video/audio)
+ * never touch sharp regardless.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+/**
+ * Backend cap is 4.5 MB decoded; we target 4 MB to leave headroom for the
+ * base64 overhead + JSON-RPC envelope size. Anything over this after
+ * compression is refused rather than silently truncated.
+ */
+const DATA_URI_TARGET_BYTES = 4 * 1024 * 1024;
+/**
+ * Fluxpool backend allow-list per type. Kept in sync with the backend
+ * ALLOWED_MIME_BY_TYPE (functions/ingestion/index.js). Keeping the client
+ * strict too means a mistyped MIME fails locally with a specific message,
+ * instead of trekking to the server for a generic 415.
+ */
+const ALLOWED_MIME_BY_TYPE = {
+    image: new Set(['image/png', 'image/jpeg', 'image/jpg', 'image/webp', 'image/gif']),
+    video: new Set(['video/mp4', 'video/webm', 'video/quicktime']),
+    audio: new Set(['audio/mpeg', 'audio/wav', 'audio/ogg', 'audio/mp4']),
+};
+const MIME_BY_EXT = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+    '.gif': 'image/gif',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.mov': 'video/quicktime',
+    '.mp3': 'audio/mpeg',
+    '.wav': 'audio/wav',
+    '.ogg': 'audio/ogg',
+    '.m4a': 'audio/mp4',
+};
+/**
+ * Walk a params object, rewriting every {source:'local'} entry inside
+ * `inputs[]` to {source:'data'}. Mutates in place and returns it so
+ * callers can chain.
+ *
+ * Throws with a plain Error whose message the bridge relays back to the
+ * MCP client as a JSON-RPC error. The message is written for the human
+ * on the other end of the client, not for a machine.
+ */
+export async function resolveLocalInputs(params, options = {}) {
+    if (!isObject(params))
+        return params;
+    const inputs = params.inputs;
+    if (!Array.isArray(inputs))
+        return params;
+    const readFile = options.readFile ?? ((p) => fs.readFile(p));
+    const loadSharp = options.loadSharp ?? defaultLoadSharp;
+    let sharpModule; // lazy
+    for (let i = 0; i < inputs.length; i++) {
+        const item = inputs[i];
+        if (!isObject(item))
+            continue;
+        if (item.source !== 'local')
+            continue;
+        const type = String(item.type || 'image').toLowerCase();
+        const pathValue = item.value;
+        if (typeof pathValue !== 'string' || pathValue === '') {
+            throw new Error(`inputs[${i}].value must be a file path string when source='local'`);
+        }
+        if (!ALLOWED_MIME_BY_TYPE[type]) {
+            throw new Error(`inputs[${i}].type must be one of: image, video, audio (got '${type}')`);
+        }
+        let buf;
+        try {
+            buf = await readFile(pathValue);
+        }
+        catch (cause) {
+            throw new Error(`inputs[${i}]: could not read local file '${pathValue}': ${describe(cause)}`);
+        }
+        let mime = detectMimeFromPath(pathValue);
+        if (!mime || !ALLOWED_MIME_BY_TYPE[type].has(mime)) {
+            throw new Error(`inputs[${i}]: file '${path.basename(pathValue)}' has unsupported MIME ` +
+                `'${mime ?? 'unknown'}' for type='${type}'. ` +
+                `Allowed: ${Array.from(ALLOWED_MIME_BY_TYPE[type]).join(', ')}.`);
+        }
+        // Compress oversize images with sharp when available; refuse otherwise.
+        // Video and audio never touch sharp — those callers must use the
+        // two-step upload endpoint for oversize files.
+        if (buf.length > DATA_URI_TARGET_BYTES) {
+            if (type !== 'image') {
+                throw new Error(`inputs[${i}]: ${type} file '${path.basename(pathValue)}' is ` +
+                    `${(buf.length / (1024 * 1024)).toFixed(1)} MB, over the ` +
+                    `${DATA_URI_TARGET_BYTES / (1024 * 1024)} MB inline cap. ` +
+                    `Use POST https://api.fluxpool.ai/v1/uploads to upload the file ` +
+                    `and pass source='url' with the returned URL.`);
+            }
+            if (sharpModule === undefined)
+                sharpModule = await loadSharp();
+            if (sharpModule === null) {
+                throw new Error(`inputs[${i}]: image '${path.basename(pathValue)}' is ` +
+                    `${(buf.length / (1024 * 1024)).toFixed(1)} MB, over the ` +
+                    `${DATA_URI_TARGET_BYTES / (1024 * 1024)} MB inline cap. ` +
+                    `Install optional dependency 'sharp' (npm i sharp) to enable ` +
+                    `automatic compression, or resize the image before passing it.`);
+            }
+            const compressed = await compressWithSharp(sharpModule, buf);
+            buf = compressed;
+            mime = 'image/webp';
+        }
+        item.source = 'data';
+        item.value = `data:${mime};base64,${buf.toString('base64')}`;
+    }
+    return params;
+}
+/**
+ * Two-pass compression: try quality 82, drop to 65 if still over the cap,
+ * fail with a clear message if even 65 isn't enough. Two passes cover
+ * everyday phone photos (1-4 MB after resize at q82) and unusually large
+ * source images (drops to q65 for extreme cases) without going into
+ * an unbounded quality-reduction loop.
+ */
+async function compressWithSharp(mod, buf) {
+    const pipeline = (quality) => mod
+        .default(buf)
+        .rotate() // honour EXIF orientation before resizing
+        .resize({ width: 2048, height: 2048, fit: 'inside', withoutEnlargement: true })
+        .webp({ quality })
+        .toBuffer();
+    const first = await pipeline(82);
+    if (first.length <= DATA_URI_TARGET_BYTES)
+        return first;
+    const second = await pipeline(65);
+    if (second.length <= DATA_URI_TARGET_BYTES)
+        return second;
+    throw new Error(`Image is still ${(second.length / (1024 * 1024)).toFixed(1)} MB after ` +
+        `resize to 2048px + webp q65. Resize the source further or upload it ` +
+        `via POST https://api.fluxpool.ai/v1/uploads and pass source='url'.`);
+}
+async function defaultLoadSharp() {
+    try {
+        // Dynamic import so sharp stays a truly optional dependency: callers
+        // who never pass a local path never pay the ~30 MB install cost.
+        // The string is opaque to tsc so a missing @types/sharp does not
+        // become a build error — the module is loaded (or not) at runtime.
+        const specifier = 'sharp';
+        return (await import(specifier));
+    }
+    catch {
+        return null;
+    }
+}
+function detectMimeFromPath(p) {
+    const ext = path.extname(p).toLowerCase();
+    return MIME_BY_EXT[ext] ?? null;
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function describe(cause) {
+    return cause instanceof Error ? cause.message : String(cause);
+}
+/**
+ * True when the message is a `tools/call` for `create_generation` that
+ * has `inputs[]` with at least one `source: 'local'` entry. Cheap check
+ * used by the bridge to decide whether to run the resolver.
+ */
+export function needsLocalResolution(message) {
+    if (!isObject(message))
+        return false;
+    if (message.method !== 'tools/call')
+        return false;
+    const params = message.params;
+    if (!isObject(params))
+        return false;
+    if (params.name !== 'create_generation')
+        return false;
+    const args = params.arguments;
+    if (!isObject(args))
+        return false;
+    const inputs = args.inputs;
+    if (!Array.isArray(inputs))
+        return false;
+    return inputs.some((it) => isObject(it) && it.source === 'local');
+}
+//# sourceMappingURL=localInputs.js.map

package/dist/localInputs.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/package.json CHANGED Viewed

@@ -1,50 +1,59 @@
-{
-  "name": "@fluxpool/mcp-server",
-  "version": "0.1.0",
-  "description": "MCP server for Fluxpool.ai — generate images and videos across Flux, Seedream, Seedance, Runway and more from Claude, Cursor, or any MCP client.",
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "fluxpool",
-    "ai",
-    "image-generation",
-    "video-generation",
-    "claude",
-    "cursor"
-  ],
-  "homepage": "https://fluxpool.ai",
-  "bugs": {
-    "url": "https://github.com/ZKcandy/fluxpool-mcp-server/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ZKcandy/fluxpool-mcp-server.git"
-  },
-  "license": "MIT",
-  "author": "Fluxpool",
-  "type": "module",
-  "bin": {
-    "fluxpool-mcp": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build && npm test",
-    "start": "node dist/index.js",
-    "test": "npm run build && node --test test/"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4"
-  },
-  "devDependencies": {
-    "@types/node": "^22.10.2",
-    "typescript": "^5.7.2"
-  }
-}
+{
+  "name": "@fluxpool/mcp-server",
+  "version": "0.2.0",
+  "description": "MCP server for Fluxpool.ai — generate images and videos across Flux, Seedream, Seedance, Runway and more from Claude, Cursor, or any MCP client.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "fluxpool",
+    "ai",
+    "image-generation",
+    "video-generation",
+    "claude",
+    "cursor"
+  ],
+  "homepage": "https://fluxpool.ai",
+  "bugs": {
+    "url": "https://github.com/ZKcandy/fluxpool-mcp-server/issues",
+    "email": "dev@fluxpool.ai"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ZKcandy/fluxpool-mcp-server.git"
+  },
+  "license": "MIT",
+  "author": "Fluxpool <dev@fluxpool.ai>",
+  "type": "module",
+  "bin": {
+    "fluxpool-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build && npm test",
+    "start": "node dist/index.js",
+    "test": "npm run build && node --test test/"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "optionalDependencies": {
+    "sharp": "^0.33.5"
+  },
+  "peerDependenciesMeta": {
+    "sharp": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  }
+}