@xyzensun/visionmcp 0.1.0

package/README.md

@@ -0,0 +1,120 @@
+# @xyzensun/visionmcp
+
+[English](./README.md) | [中文](./README_CN.md)
+
+A Node.js MCP stdio server that exposes a single image-understanding tool (`readimg`) for MCP clients that lack native multimodal input. The tool forwards the image to a user-configured multimodal model and returns plain text.
+
+Supports three upstream request formats out of the box: **OpenAI**, **Anthropic**, **Gemini**.
+
+## Install / use via MCP
+
+No global install needed. Configure your MCP client to launch the package via `npx`:
+
+```json
+{
+  "mcpServers": {
+    "visionmcp": {
+      "command": "npx",
+      "args": ["-y", "@xyzensun/visionmcp"],
+      "env": {
+        "BASE_URL": "https://api-inference.modelscope.ai",
+        "FORMAT": "openai",
+        "API_KEY": "your_api_key_here",
+        "MODEL": "Qwen/Qwen3-VL-235B-A22B-Instruct"
+      }
+    }
+  }
+}
+```
+
+> Do not commit `API_KEY` or any MCP config file containing secrets.
+
+## Required environment variables
+
+| Variable   | Description                                                                                       |
+| ---------- | ------------------------------------------------------------------------------------------------- |
+| `BASE_URL` | Service root URL, e.g. `https://api-inference.modelscope.ai`. **Do not include the API path** — paths are appended automatically per `FORMAT`. |
+| `FORMAT`   | One of `openai`, `anthropic`, `gemini`.                                                           |
+| `API_KEY`  | Upstream provider API key.                                                                        |
+| `MODEL`    | Model identifier sent to the upstream endpoint.                                                   |
+
+## Tool: `readimg`
+
+Parameters:
+
+```ts
+{
+  image_path?: string;       // absolute local file path
+  image_base64?: string;     // raw base64 or data URL (data:image/png;base64,...)
+  mime_type?: string;        // optional MIME override
+  prompt?: string;           // optional; default: "请详细描述这张图片"
+  timeout_seconds?: number;  // optional; default 120; aborts upstream on timeout
+}
+```
+
+- Exactly one of `image_path` or `image_base64` must be provided.
+- `image_path` must be a local path; `http://` / `https://` URLs are rejected.
+- MIME inference: file extension for local paths, prefix for data URLs, fallback `image/png`.
+- On timeout, the upstream request is aborted via `AbortSignal` and the tool returns `timeout after <N> seconds`.
+
+### Local path example
+
+```json
+{
+  "image_path": "/absolute/path/to/image.png",
+  "prompt": "Describe the main objects in this image."
+}
+```
+
+### Base64 example
+
+```json
+{
+  "image_base64": "data:image/png;base64,iVBORw0KGgo=",
+  "prompt": "What is in this image?",
+  "timeout_seconds": 60
+}
+```
+
+## Provider path conventions
+
+| Format      | Method | URL                                                       |
+| ----------- | ------ | --------------------------------------------------------- |
+| `openai`    | POST   | `{BASE_URL}/v1/chat/completions`                          |
+| `anthropic` | POST   | `{BASE_URL}/v1/messages`                                  |
+| `gemini`    | POST   | `{BASE_URL}/v1beta/models/{MODEL}:generateContent`        |
+
+All requests are non-streaming and send `temperature: 0.7`. `max_tokens` is not set.
+
+## What is not supported
+
+- Remote image URLs (`http://` / `https://` in `image_path`).
+- Multiple images per call.
+- Structured JSON output.
+- Caller-provided `temperature` / `max_tokens`.
+- Local path allowlists or isolation.
+- Custom upstream endpoint paths beyond the conventions above.
+
+## Security notes
+
+Local files are read with the server process's filesystem permissions; the MVP does not restrict paths. Use only in trusted local MCP environments under your own control. Remote URL fetching is disabled to avoid SSRF.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+Manual MCP client smoke test:
+
+```bash
+API_KEY=<your_key> \
+MODEL=Qwen/Qwen3-VL-235B-A22B-Instruct \
+node test/mcp-client.mjs ./test/sample.png "Describe this image"
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export declare const SUPPORTED_FORMATS: readonly ["openai", "anthropic", "gemini"];
+export type ProviderFormat = (typeof SUPPORTED_FORMATS)[number];
+export type ServerConfig = {
+    baseUrl: string;
+    format: ProviderFormat;
+    apiKey: string;
+    model: string;
+};
+export declare function loadConfig(env?: NodeJS.ProcessEnv): ServerConfig;

package/dist/config.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+export const SUPPORTED_FORMATS = ["openai", "anthropic", "gemini"];
+const envSchema = z.object({
+    BASE_URL: z.string().trim().min(1, "BASE_URL is required"),
+    FORMAT: z.enum(SUPPORTED_FORMATS, {
+        errorMap: () => ({ message: "FORMAT must be one of openai, anthropic, or gemini" }),
+    }),
+    API_KEY: z.string().trim().min(1, "API_KEY is required"),
+    MODEL: z.string().trim().min(1, "MODEL is required"),
+});
+export function loadConfig(env = process.env) {
+    const parsed = envSchema.safeParse(env);
+    if (!parsed.success) {
+        const message = parsed.error.issues.map(formatConfigIssue).join("; ");
+        throw new Error(message);
+    }
+    return {
+        baseUrl: parsed.data.BASE_URL.replace(/\/+$/, ""),
+        format: parsed.data.FORMAT,
+        apiKey: parsed.data.API_KEY,
+        model: parsed.data.MODEL,
+    };
+}
+function formatConfigIssue(issue) {
+    const name = issue.path.join(".");
+    return name ? `${name}: ${issue.message}` : issue.message;
+}
+//# 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,OAAO,EAAE,CAAC,EAAiB,MAAM,KAAK,CAAC;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAU5E,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sBAAsB,CAAC;IAC1D,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAChC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;KACpF,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;CACrD,CAAC,CAAC;AAEH,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAExC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACjD,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;QAC1B,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO;QAC3B,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAe;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;AAC5D,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class UpstreamError extends Error {
+    constructor(status: number, body: string);
+}
+export declare function parseJsonResponse(response: Response): Promise<unknown>;
+export declare function truncateSummary(value: string): string;
+export declare function asErrorMessage(error: unknown): string;

package/dist/errors.js

@@ -0,0 +1,32 @@
+const UPSTREAM_SUMMARY_LIMIT = 500;
+export class UpstreamError extends Error {
+    constructor(status, body) {
+        super(`Upstream request failed with status ${status}: ${truncateSummary(body)}`);
+        this.name = "UpstreamError";
+    }
+}
+export async function parseJsonResponse(response) {
+    const text = await response.text();
+    if (!response.ok) {
+        throw new UpstreamError(response.status, text);
+    }
+    if (!text.trim()) {
+        return {};
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error("Upstream response was not valid JSON");
+    }
+}
+export function truncateSummary(value) {
+    const normalized = value.replace(/\s+/g, " ").trim();
+    return normalized.length > UPSTREAM_SUMMARY_LIMIT
+        ? `${normalized.slice(0, UPSTREAM_SUMMARY_LIMIT)}...`
+        : normalized;
+}
+export function asErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,MAAc,EAAE,IAAY;QACtC,KAAK,CAAC,uCAAuC,MAAM,KAAK,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAkB;IACxD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,OAAO,UAAU,CAAC,MAAM,GAAG,sBAAsB;QAC/C,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,KAAK;QACrD,CAAC,CAAC,UAAU,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/image.d.ts

@@ -0,0 +1,8 @@
+import type { AnalyzeImageInput } from "./schema.js";
+export type LoadedImage = {
+    base64: string;
+    mimeType: string;
+};
+export declare function loadImage(input: AnalyzeImageInput): Promise<LoadedImage>;
+export declare function parseBase64Image(value: string, mimeType?: string): LoadedImage;
+export declare function inferMimeType(filePath: string): string;

package/dist/image.js

@@ -0,0 +1,69 @@
+import { extname } from "node:path";
+import { readFile } from "node:fs/promises";
+const MIME_BY_EXTENSION = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+};
+const DATA_URL_PATTERN = /^data:([^;,]+);base64,(.*)$/s;
+const BASE64_PATTERN = /^[A-Za-z0-9+/]+={0,2}$/;
+export async function loadImage(input) {
+    if (input.image_path) {
+        return loadImagePath(input.image_path, input.mime_type);
+    }
+    if (input.image_base64) {
+        return parseBase64Image(input.image_base64, input.mime_type);
+    }
+    throw new Error("Exactly one of image_path or image_base64 must be provided");
+}
+async function loadImagePath(imagePath, mimeType) {
+    if (/^https?:\/\//i.test(imagePath)) {
+        throw new Error("image_path must be a local file path, not an HTTP or HTTPS URL");
+    }
+    try {
+        const file = await readFile(imagePath);
+        return {
+            base64: file.toString("base64"),
+            mimeType: mimeType ?? inferMimeType(imagePath),
+        };
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new Error(`Unable to read local image file: ${reason}`);
+    }
+}
+export function parseBase64Image(value, mimeType) {
+    const trimmed = value.trim();
+    const dataUrlMatch = DATA_URL_PATTERN.exec(trimmed);
+    if (dataUrlMatch) {
+        const [, dataUrlMimeType, data] = dataUrlMatch;
+        const base64 = normalizeBase64(data);
+        return {
+            base64,
+            mimeType: mimeType ?? dataUrlMimeType,
+        };
+    }
+    return {
+        base64: normalizeBase64(trimmed),
+        mimeType: mimeType ?? "image/png",
+    };
+}
+export function inferMimeType(filePath) {
+    return MIME_BY_EXTENSION[extname(filePath).toLowerCase()] ?? "image/png";
+}
+function normalizeBase64(value) {
+    const compact = value.replace(/\s/g, "");
+    if (!compact || compact.length % 4 !== 0 || !BASE64_PATTERN.test(compact)) {
+        throw new Error("Invalid base64 image input");
+    }
+    try {
+        Buffer.from(compact, "base64");
+        return compact;
+    }
+    catch {
+        throw new Error("Invalid base64 image input");
+    }
+}
+//# sourceMappingURL=image.js.map

package/dist/image.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { asErrorMessage } from "./errors.js";
+import { loadImage } from "./image.js";
+import { getProvider } from "./providers/index.js";
+import { DEFAULT_PROMPT, analyzeImageInputShape, parseAnalyzeImageInput } from "./schema.js";
+import { DEFAULT_TIMEOUT_SECONDS, withTimeout } from "./timeout.js";
+const server = new McpServer({
+    name: "visionmcp",
+    version: "0.1.0",
+});
+server.tool("readimg", `readimg is an image-reading tool backed by a specialized vision LLM. It accepts a base64-encoded image or an absolute local file path, and supports an optional custom prompt (a sensible default is used when omitted) and a configurable timeout (defaults to 120 seconds).
+  there is an json scheme example
+<example>
+{
+  "image_path": "/absolute/path/to/photo.png",
+  "prompt": "What objects are visible in this image?",
+  "timeout_seconds": 60
+}
+</example>`, analyzeImageInputShape, async (input) => {
+    try {
+        const parsedInput = parseAnalyzeImageInput(input);
+        const config = loadConfig();
+        const image = await loadImage(parsedInput);
+        const provider = getProvider(config.format);
+        const text = await withTimeout(parsedInput.timeout_seconds ?? DEFAULT_TIMEOUT_SECONDS, (signal) => provider.analyze(config, {
+            prompt: parsedInput.prompt ?? DEFAULT_PROMPT,
+            image,
+            signal,
+        }));
+        return {
+            content: [{ type: "text", text }],
+        };
+    }
+    catch (error) {
+        throw new Error(asErrorMessage(error));
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,IAAI,CACT,SAAS,EACT;;;;;;;;WAQS,EACT,sBAAsB,EACtB,KAAK,EAAE,KAAK,EAAE,EAAE;IACd,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,eAAe,IAAI,uBAAuB,EAAE,CAAC,MAAM,EAAE,EAAE,CAChG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE;YACvB,MAAM,EAAE,WAAW,CAAC,MAAM,IAAI,cAAc;YAC5C,KAAK;YACL,MAAM;SACP,CAAC,CACH,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAClC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;AACH,CAAC,CACF,CAAC;AAEF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderAdapter } from "./types.js";
+export declare const anthropicProvider: ProviderAdapter;
+export declare function extractAnthropicText(json: unknown): string;

package/dist/providers/anthropic.js

@@ -0,0 +1,51 @@
+import { parseJsonResponse } from "../errors.js";
+import { joinBaseUrl } from "./base-url.js";
+export const anthropicProvider = {
+    async analyze(config, request) {
+        const response = await fetch(joinBaseUrl(config.baseUrl, "/v1/messages"), {
+            method: "POST",
+            headers: {
+                "x-api-key": config.apiKey,
+                "anthropic-version": "2023-06-01",
+                "Content-Type": "application/json",
+            },
+            signal: request.signal,
+            body: JSON.stringify({
+                model: config.model,
+                temperature: 0.7,
+                messages: [
+                    {
+                        role: "user",
+                        content: [
+                            {
+                                type: "image",
+                                source: {
+                                    type: "base64",
+                                    media_type: request.image.mimeType,
+                                    data: request.image.base64,
+                                },
+                            },
+                            { type: "text", text: request.prompt },
+                        ],
+                    },
+                ],
+            }),
+        });
+        return extractAnthropicText(await parseJsonResponse(response));
+    },
+};
+export function extractAnthropicText(json) {
+    if (!isRecord(json) || !Array.isArray(json.content)) {
+        throw new Error("Anthropic response did not contain extractable text");
+    }
+    for (const block of json.content) {
+        if (isRecord(block) && block.type === "text" && typeof block.text === "string" && block.text.trim()) {
+            return block.text;
+        }
+    }
+    throw new Error("Anthropic response did not contain extractable text");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,MAAM,CAAC,MAAM,iBAAiB,GAAoB;IAChD,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO;QAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE;YACxE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,WAAW,EAAE,MAAM,CAAC,MAAM;gBAC1B,mBAAmB,EAAE,YAAY;gBACjC,cAAc,EAAE,kBAAkB;aACnC;YACD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,GAAG;gBAChB,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,OAAO;gCACb,MAAM,EAAE;oCACN,IAAI,EAAE,QAAQ;oCACd,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ;oCAClC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;iCAC3B;6BACF;4BACD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE;yBACvC;qBACF;iBACF;aACF,CAAC;SACH,CAAC,CAAC;QAEH,OAAO,oBAAoB,CAAC,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjE,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACpG,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/providers/base-url.d.ts

@@ -0,0 +1 @@
+export declare function joinBaseUrl(baseUrl: string, path: string): string;

package/dist/providers/base-url.js

@@ -0,0 +1,4 @@
+export function joinBaseUrl(baseUrl, path) {
+    return `${baseUrl.replace(/\/+$/, "")}${path.startsWith("/") ? path : `/${path}`}`;
+}
+//# sourceMappingURL=base-url.js.map

package/dist/providers/base-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-url.js","sourceRoot":"","sources":["../../src/providers/base-url.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAY;IACvD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACrF,CAAC"}

package/dist/providers/gemini.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderAdapter } from "./types.js";
+export declare const geminiProvider: ProviderAdapter;
+export declare function extractGeminiText(json: unknown): string;

package/dist/providers/gemini.js

@@ -0,0 +1,53 @@
+import { parseJsonResponse } from "../errors.js";
+import { joinBaseUrl } from "./base-url.js";
+export const geminiProvider = {
+    async analyze(config, request) {
+        const response = await fetch(joinBaseUrl(config.baseUrl, `/v1beta/models/${encodeURIComponent(config.model)}:generateContent`), {
+            method: "POST",
+            headers: {
+                "x-goog-api-key": config.apiKey,
+                "Content-Type": "application/json",
+            },
+            signal: request.signal,
+            body: JSON.stringify({
+                contents: [
+                    {
+                        parts: [
+                            { text: request.prompt },
+                            {
+                                inline_data: {
+                                    mime_type: request.image.mimeType,
+                                    data: request.image.base64,
+                                },
+                            },
+                        ],
+                    },
+                ],
+                generationConfig: {
+                    temperature: 0.7,
+                },
+            }),
+        });
+        return extractGeminiText(await parseJsonResponse(response));
+    },
+};
+export function extractGeminiText(json) {
+    if (!isRecord(json) || !Array.isArray(json.candidates)) {
+        throw new Error("Gemini response did not contain extractable text");
+    }
+    for (const candidate of json.candidates) {
+        if (!isRecord(candidate) || !isRecord(candidate.content) || !Array.isArray(candidate.content.parts)) {
+            continue;
+        }
+        for (const part of candidate.content.parts) {
+            if (isRecord(part) && typeof part.text === "string" && part.text.trim()) {
+                return part.text;
+            }
+        }
+    }
+    throw new Error("Gemini response did not contain extractable text");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=gemini.js.map

package/dist/providers/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO;QAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,kBAAkB,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE;YAC9H,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,gBAAgB,EAAE,MAAM,CAAC,MAAM;gBAC/B,cAAc,EAAE,kBAAkB;aACnC;YACD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,QAAQ,EAAE;oBACR;wBACE,KAAK,EAAE;4BACL,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE;4BACxB;gCACE,WAAW,EAAE;oCACX,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ;oCACjC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;iCAC3B;6BACF;yBACF;qBACF;iBACF;gBACD,gBAAgB,EAAE;oBAChB,WAAW,EAAE,GAAG;iBACjB;aACF,CAAC;SACH,CAAC,CAAC;QAEH,OAAO,iBAAiB,CAAC,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9D,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACpG,SAAS;QACX,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBACxE,OAAO,IAAI,CAAC,IAAI,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/providers/index.d.ts

@@ -0,0 +1,4 @@
+import type { ProviderFormat } from "../config.js";
+import type { ProviderAdapter } from "./types.js";
+export declare function getProvider(format: ProviderFormat): ProviderAdapter;
+export type { AnalyzeRequest, ProviderAdapter } from "./types.js";

package/dist/providers/index.js

@@ -0,0 +1,12 @@
+import { anthropicProvider } from "./anthropic.js";
+import { geminiProvider } from "./gemini.js";
+import { openaiProvider } from "./openai.js";
+const PROVIDERS = {
+    openai: openaiProvider,
+    anthropic: anthropicProvider,
+    gemini: geminiProvider,
+};
+export function getProvider(format) {
+    return PROVIDERS[format];
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,SAAS,GAA4C;IACzD,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,iBAAiB;IAC5B,MAAM,EAAE,cAAc;CACvB,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,MAAsB;IAChD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderAdapter } from "./types.js";
+export declare const openaiProvider: ProviderAdapter;
+export declare function extractOpenAiText(json: unknown): string;

package/dist/providers/openai.js

@@ -0,0 +1,62 @@
+import { parseJsonResponse } from "../errors.js";
+import { joinBaseUrl } from "./base-url.js";
+export const openaiProvider = {
+    async analyze(config, request) {
+        const response = await fetch(joinBaseUrl(config.baseUrl, "/v1/chat/completions"), {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${config.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            signal: request.signal,
+            body: JSON.stringify({
+                model: config.model,
+                temperature: 0.7,
+                messages: [
+                    {
+                        role: "user",
+                        content: [
+                            { type: "text", text: request.prompt },
+                            {
+                                type: "image_url",
+                                image_url: {
+                                    url: `data:${request.image.mimeType};base64,${request.image.base64}`,
+                                },
+                            },
+                        ],
+                    },
+                ],
+            }),
+        });
+        return extractOpenAiText(await parseJsonResponse(response));
+    },
+};
+export function extractOpenAiText(json) {
+    if (!isRecord(json)) {
+        throw new Error("OpenAI response did not contain extractable text");
+    }
+    const choices = json.choices;
+    if (!Array.isArray(choices) || choices.length === 0 || !isRecord(choices[0])) {
+        throw new Error("OpenAI response did not contain extractable text");
+    }
+    const message = choices[0].message;
+    if (!isRecord(message)) {
+        throw new Error("OpenAI response did not contain extractable text");
+    }
+    const content = message.content;
+    if (typeof content === "string" && content.trim()) {
+        return content;
+    }
+    if (Array.isArray(content)) {
+        for (const block of content) {
+            if (isRecord(block) && typeof block.text === "string" && block.text.trim()) {
+                return block.text;
+            }
+        }
+    }
+    throw new Error("OpenAI response did not contain extractable text");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO;QAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,sBAAsB,CAAC,EAAE;YAChF,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;gBACxC,cAAc,EAAE,kBAAkB;aACnC;YACD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,GAAG;gBAChB,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE;4BACtC;gCACE,IAAI,EAAE,WAAW;gCACjB,SAAS,EAAE;oCACT,GAAG,EAAE,QAAQ,OAAO,CAAC,KAAK,CAAC,QAAQ,WAAW,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE;iCACrE;6BACF;yBACF;qBACF;iBACF;aACF,CAAC;SACH,CAAC,CAAC;QAEH,OAAO,iBAAiB,CAAC,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9D,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACnC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC3E,OAAO,KAAK,CAAC,IAAI,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/providers/types.d.ts

@@ -0,0 +1,10 @@
+import type { ServerConfig } from "../config.js";
+import type { LoadedImage } from "../image.js";
+export type AnalyzeRequest = {
+    prompt: string;
+    image: LoadedImage;
+    signal?: AbortSignal;
+};
+export type ProviderAdapter = {
+    analyze(config: ServerConfig, request: AnalyzeRequest): Promise<string>;
+};

package/dist/providers/types.js

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

package/dist/providers/types.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export declare const DEFAULT_PROMPT = "\u8BF7\u8BE6\u7EC6\u63CF\u8FF0\u8FD9\u5F20\u56FE\u7247";
+export declare const analyzeImageInputShape: {
+    image_path: z.ZodOptional<z.ZodString>;
+    image_base64: z.ZodOptional<z.ZodString>;
+    mime_type: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    timeout_seconds: z.ZodOptional<z.ZodNumber>;
+};
+export declare const analyzeImageInputSchema: z.ZodEffects<z.ZodObject<{
+    image_path: z.ZodOptional<z.ZodString>;
+    image_base64: z.ZodOptional<z.ZodString>;
+    mime_type: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+    timeout_seconds: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    image_path?: string | undefined;
+    image_base64?: string | undefined;
+    mime_type?: string | undefined;
+    prompt?: string | undefined;
+    timeout_seconds?: number | undefined;
+}, {
+    image_path?: string | undefined;
+    image_base64?: string | undefined;
+    mime_type?: string | undefined;
+    prompt?: string | undefined;
+    timeout_seconds?: number | undefined;
+}>, {
+    image_path?: string | undefined;
+    image_base64?: string | undefined;
+    mime_type?: string | undefined;
+    prompt?: string | undefined;
+    timeout_seconds?: number | undefined;
+}, {
+    image_path?: string | undefined;
+    image_base64?: string | undefined;
+    mime_type?: string | undefined;
+    prompt?: string | undefined;
+    timeout_seconds?: number | undefined;
+}>;
+export type AnalyzeImageInput = z.infer<typeof analyzeImageInputSchema>;
+export declare function parseAnalyzeImageInput(input: unknown): AnalyzeImageInput;

package/dist/schema.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export const DEFAULT_PROMPT = "请详细描述这张图片";
+export const analyzeImageInputShape = {
+    image_path: z.string().optional(),
+    image_base64: z.string().optional(),
+    mime_type: z.string().optional(),
+    prompt: z.string().optional(),
+    timeout_seconds: z.number().positive().optional(),
+};
+export const analyzeImageInputSchema = z
+    .object(analyzeImageInputShape)
+    .strict()
+    .superRefine((value, ctx) => {
+    const hasPath = typeof value.image_path === "string" && value.image_path.length > 0;
+    const hasBase64 = typeof value.image_base64 === "string" && value.image_base64.length > 0;
+    if (hasPath === hasBase64) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Exactly one of image_path or image_base64 must be provided",
+            path: ["image_path"],
+        });
+    }
+    if (hasPath && /^https?:\/\//i.test(value.image_path ?? "")) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "image_path must be a local file path, not an HTTP or HTTPS URL",
+            path: ["image_path"],
+        });
+    }
+});
+export function parseAnalyzeImageInput(input) {
+    const parsed = analyzeImageInputSchema.safeParse(input);
+    if (!parsed.success) {
+        const message = parsed.error.issues.map((issue) => issue.message).join("; ");
+        throw new Error(message);
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAClD,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,MAAM,CAAC,sBAAsB,CAAC;KAC9B,MAAM,EAAE;KACR,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC1B,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAE1F,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,4DAA4D;YACrE,IAAI,EAAE,CAAC,YAAY,CAAC;SACrB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,gEAAgE;YACzE,IAAI,EAAE,CAAC,YAAY,CAAC;SACrB,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAIL,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAExD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/timeout.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_TIMEOUT_SECONDS = 120;
+export declare function withTimeout<T>(timeoutSeconds: number, operation: (signal: AbortSignal) => Promise<T>): Promise<T>;

package/dist/timeout.js

@@ -0,0 +1,21 @@
+export const DEFAULT_TIMEOUT_SECONDS = 120;
+export async function withTimeout(timeoutSeconds, operation) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutSeconds * 1000);
+    try {
+        return await operation(controller.signal);
+    }
+    catch (error) {
+        if (controller.signal.aborted || isAbortError(error)) {
+            throw new Error(`timeout after ${timeoutSeconds} seconds`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function isAbortError(error) {
+    return error instanceof Error && error.name === "AbortError";
+}
+//# sourceMappingURL=timeout.js.map

package/dist/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../src/timeout.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,cAAsB,EAAE,SAA8C;IACzG,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC;IAE5E,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,iBAAiB,cAAc,UAAU,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;AAC/D,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@xyzensun/visionmcp",
+  "version": "0.1.0",
+  "description": "MCP stdio server for image understanding through configurable multimodal providers (OpenAI / Anthropic / Gemini formats).",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "visionmcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "vision",
+    "image-understanding",
+    "multimodal",
+    "openai",
+    "anthropic",
+    "gemini"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.13.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}