@stabgan/openrouter-mcp-multimodal 4.6.0 → 4.6.1

package/dist/index.js

@@ -7,6 +7,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { ToolHandlers } from './tool-handlers.js';
 import { logger } from './logger.js';
 import { SERVER_VERSION } from './version.js';
+import { SERVER_ICON } from './tool-icons.js';
 const DEFAULT_MODEL = 'nvidia/nemotron-nano-12b-v2-vl:free';
 // Exit on fatal errors to prevent silent zombie processes (issue #5).
 // We log an explicit whitelist of fields rather than the raw error object
@@ -37,7 +38,14 @@ if (!apiKey) {
     process.exit(1);
 }
 const defaultModel = process.env.OPENROUTER_DEFAULT_MODEL || process.env.DEFAULT_MODEL || DEFAULT_MODEL;
-const server = new Server({ name: 'openrouter-multimodal-server', version: SERVER_VERSION }, { capabilities: { tools: {} } });
+const server = new Server({
+    name: 'openrouter-multimodal-server',
+    version: SERVER_VERSION,
+    title: 'OpenRouter MCP Multimodal',
+    description: 'MCP server for OpenRouter — chat with 300+ LLMs, analyze/generate images, audio, and video.',
+    websiteUrl: 'https://github.com/stabgan/openrouter-mcp-multimodal',
+    icons: SERVER_ICON,
+}, { capabilities: { tools: {} } });
 server.onerror = (error) => logFatal('mcpError', error);
 new ToolHandlers(server, apiKey, defaultModel);
 process.on('SIGINT', async () => {

package/dist/tool-descriptions.js

@@ -113,12 +113,10 @@ export const TOOL_DESCRIPTIONS = {
             'Polling for a long-running reasoning model result',
         ],
         notWhen: [
-            'You haven\'t started a job yet → use start_chat_completion first',
+            "You haven't started a job yet → use start_chat_completion first",
             'You want to start a new completion',
         ],
-        goodExamples: [
-            '`{ "job_id": "chat_20260806_001" }`',
-        ],
+        goodExamples: ['`{ "job_id": "chat_20260806_001" }`'],
         badExamples: [
             '`{ "job_id": "" }` → INVALID_INPUT',
             '`{ "job_id": "nonexistent" }` → job not found',
@@ -322,7 +320,7 @@ export const TOOL_DESCRIPTIONS = {
         worksWith: ['analyze_image', 'generate_video_from_image'],
     }),
     generate_image_dedicated: buildToolDescription({
-        summary: 'Generate images via OpenRouter\'s dedicated Image API (POST /api/v1/images). Supports ' +
+        summary: "Generate images via OpenRouter's dedicated Image API (POST /api/v1/images). Supports " +
             'normalized resolution tiers, quality levels, output format selection, and reference images. ' +
             'New image models are added exclusively to this endpoint. Default model: google/gemini-2.5-flash-image.',
         useWhen: [
@@ -348,7 +346,7 @@ export const TOOL_DESCRIPTIONS = {
         failsWhen: [
             'INVALID_INPUT: empty prompt, invalid resolution/quality/output_format',
             'UNSAFE_PATH: save_path or input_references escaped sandbox',
-            'UPSTREAM_REFUSED: content policy, model doesn\'t support requested options',
+            "UPSTREAM_REFUSED: content policy, model doesn't support requested options",
             'MODEL_NOT_FOUND: invalid model slug',
         ],
         worksWith: ['analyze_image', 'generate_video_from_image'],
@@ -376,7 +374,7 @@ export const TOOL_DESCRIPTIONS = {
         worksWith: ['analyze_audio'],
     }),
     text_to_speech: buildToolDescription({
-        summary: 'Convert text to speech via OpenRouter\'s dedicated TTS endpoint (POST /api/v1/audio/speech). ' +
+        summary: "Convert text to speech via OpenRouter's dedicated TTS endpoint (POST /api/v1/audio/speech). " +
             'Faster and cheaper than chat completions for pure TTS. Models: OpenAI GPT-4o Mini TTS, Google Gemini Flash TTS, Mistral Voxtral.',
         useWhen: [
             'You need text-to-speech with specific voice control',
@@ -406,7 +404,7 @@ export const TOOL_DESCRIPTIONS = {
         worksWith: ['speech_to_text', 'analyze_audio'],
     }),
     speech_to_text: buildToolDescription({
-        summary: 'Transcribe audio via OpenRouter\'s dedicated STT endpoint (POST /api/v1/audio/transcriptions). ' +
+        summary: "Transcribe audio via OpenRouter's dedicated STT endpoint (POST /api/v1/audio/transcriptions). " +
             'Faster and cheaper than chat completions for pure transcription. Models: Whisper-1, GPT-4o Transcribe, Voxtral.',
         useWhen: [
             'You need fast transcription of audio files',

package/dist/tool-handlers/async-chat.js

@@ -20,7 +20,7 @@ import path from 'node:path';
 import { ErrorCode, toolError } from '../errors.js';
 import { SERVER_VERSION } from '../version.js';
 import { logger } from '../logger.js';
-import { extractCompletionText, buildCompletionMeta, } from './completion-utils.js';
+import { extractCompletionText, buildCompletionMeta } from './completion-utils.js';
 import { readProviderDefaults, mergeProviderOptions, buildProviderBody, resolveMaxTokens, } from './provider-routing.js';
 import { buildCacheHeaders } from './cache.js';
 // ─── Job Store ───────────────────────────────────────────────────────────────

package/dist/tool-handlers/generate-image-dedicated.js

@@ -10,7 +10,7 @@
  */
 import { promises as fs } from 'fs';
 import path from 'node:path';
-import { resolveSafeOutputPath, resolveSafeInputPath, UnsafeOutputPathError } from './path-safety.js';
+import { resolveSafeOutputPath, resolveSafeInputPath, UnsafeOutputPathError, } from './path-safety.js';
 import { ErrorCode, toolError, toolErrorFrom } from '../errors.js';
 import { SERVER_VERSION } from '../version.js';
 import { logger } from '../logger.js';
@@ -36,11 +36,15 @@ async function resolveReference(source) {
     const abs = await resolveSafeInputPath(trimmed);
     const buf = await fs.readFile(abs);
     const ext = path.extname(abs).toLowerCase();
-    const mime = ext === '.png' ? 'image/png' :
-        ext === '.webp' ? 'image/webp' :
-            ext === '.gif' ? 'image/gif' :
-                ext === '.svg' ? 'image/svg+xml' :
-                    'image/jpeg';
+    const mime = ext === '.png'
+        ? 'image/png'
+        : ext === '.webp'
+            ? 'image/webp'
+            : ext === '.gif'
+                ? 'image/gif'
+                : ext === '.svg'
+                    ? 'image/svg+xml'
+                    : 'image/jpeg';
     const dataUrl = `data:${mime};base64,${buf.toString('base64')}`;
     return { type: 'image_url', image_url: { url: dataUrl } };
 }
@@ -128,11 +132,15 @@ export async function handleGenerateImageDedicated(request, apiClient) {
     }
     const firstImage = images[0];
     const imageData = firstImage.b64_json;
-    const mimeType = output_format === 'png' ? 'image/png' :
-        output_format === 'webp' ? 'image/webp' :
-            output_format === 'svg' ? 'image/svg+xml' :
-                output_format === 'jpeg' ? 'image/jpeg' :
-                    'image/png'; // default
+    const mimeType = output_format === 'png'
+        ? 'image/png'
+        : output_format === 'webp'
+            ? 'image/webp'
+            : output_format === 'svg'
+                ? 'image/svg+xml'
+                : output_format === 'jpeg'
+                    ? 'image/jpeg'
+                    : 'image/png'; // default
     const baseMeta = {
         server_version: SERVER_VERSION,
         model: model || DEFAULT_MODEL,
@@ -168,9 +176,7 @@ export async function handleGenerateImageDedicated(request, apiClient) {
     }
     // URL-only response (some models return URLs instead of base64)
     return {
-        content: [
-            { type: 'text', text: `Image generated. URL: ${firstImage.url}` },
-        ],
+        content: [{ type: 'text', text: `Image generated. URL: ${firstImage.url}` }],
         _meta: { ...baseMeta, image_url: firstImage.url },
     };
 }

package/dist/tool-handlers/speech-to-text.js

@@ -20,16 +20,24 @@ const VALID_RESPONSE_FORMATS = new Set(['json', 'text', 'srt', 'verbose_json', '
 function audioFormatFromExt(ext) {
     const normalized = ext.toLowerCase().replace('.', '');
     switch (normalized) {
-        case 'mp3': return 'mp3';
+        case 'mp3':
+            return 'mp3';
         case 'mp4':
-        case 'm4a': return 'mp4';
-        case 'wav': return 'wav';
-        case 'flac': return 'flac';
+        case 'm4a':
+            return 'mp4';
+        case 'wav':
+            return 'wav';
+        case 'flac':
+            return 'flac';
         case 'ogg':
-        case 'oga': return 'ogg';
-        case 'webm': return 'webm';
-        case 'opus': return 'opus';
-        default: return 'mp3';
+        case 'oga':
+            return 'ogg';
+        case 'webm':
+            return 'webm';
+        case 'opus':
+            return 'opus';
+        default:
+            return 'mp3';
     }
 }
 /**

package/dist/tool-handlers.js

@@ -14,11 +14,12 @@ import { handleAnalyzeVideo } from './tool-handlers/analyze-video.js';
 import { handleGenerateVideo, handleGetVideoStatus, handleGenerateVideoFromImage, } from './tool-handlers/generate-video.js';
 import { handleRerankDocuments } from './tool-handlers/rerank.js';
 import { handleHealthCheck } from './tool-handlers/health-check.js';
-import { handleGenerateImageDedicated, } from './tool-handlers/generate-image-dedicated.js';
+import { handleGenerateImageDedicated } from './tool-handlers/generate-image-dedicated.js';
 import { handleTextToSpeech } from './tool-handlers/text-to-speech.js';
 import { handleSpeechToText } from './tool-handlers/speech-to-text.js';
 import { handleStartChatCompletion, handleGetChatCompletionStatus, } from './tool-handlers/async-chat.js';
 import { TOOL_DESCRIPTIONS } from './tool-descriptions.js';
+import { TOOL_ICONS } from './tool-icons.js';
 function wrapToolArgs(a) {
     return { params: { arguments: a ?? {} } };
 }
@@ -192,7 +193,9 @@ export class ToolHandlers {
                                     type: 'object',
                                     properties: {
                                         role: { type: 'string', enum: ['system', 'user', 'assistant'] },
-                                        content: { oneOf: [{ type: 'string' }, { type: 'array', items: { type: 'object' } }] },
+                                        content: {
+                                            oneOf: [{ type: 'string' }, { type: 'array', items: { type: 'object' } }],
+                                        },
                                     },
                                     required: ['role', 'content'],
                                 },
@@ -223,7 +226,10 @@ export class ToolHandlers {
                     inputSchema: {
                         type: 'object',
                         properties: {
-                            job_id: { type: 'string', description: 'The job_id returned by start_chat_completion.' },
+                            job_id: {
+                                type: 'string',
+                                description: 'The job_id returned by start_chat_completion.',
+                            },
                         },
                         required: ['job_id'],
                     },
@@ -782,7 +788,10 @@ export class ToolHandlers {
                         ],
                     },
                 },
-            ],
+            ].map((tool) => ({
+                ...tool,
+                icons: TOOL_ICONS[tool.name],
+            })),
         }));
         server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const { name, arguments: args } = request.params;

package/dist/tool-icons.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tool icons for MCP 2025-11-25+ clients that render icons in the tool list.
+ * Each icon is a minimal SVG data URI — no external hosting needed.
+ *
+ * Clients that don't support icons simply ignore the `icons` field.
+ */
+export type ToolIcon = Array<{
+    src: string;
+    mimeType: string;
+    sizes: string[];
+}>;
+/** Map of tool name → icons array for use in tool definitions. */
+export declare const TOOL_ICONS: Record<string, ToolIcon>;
+/** Server icon for use in the Server initialization metadata. */
+export declare const SERVER_ICON: ToolIcon;

package/dist/tool-icons.js

@@ -0,0 +1,59 @@
+/**
+ * Tool icons for MCP 2025-11-25+ clients that render icons in the tool list.
+ * Each icon is a minimal SVG data URI — no external hosting needed.
+ *
+ * Clients that don't support icons simply ignore the `icons` field.
+ */
+/** Encode an SVG string as a data URI. */
+function svgDataUri(svg) {
+    return `data:image/svg+xml,${encodeURIComponent(svg.trim())}`;
+}
+// Minimal 24x24 SVG icons using simple shapes
+const ICONS = {
+    chat: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#6366f1" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/></svg>`),
+    chatAsync: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#8b5cf6" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/><circle cx="17" cy="7" r="3" fill="#8b5cf6"/></svg>`),
+    image: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#10b981" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="8.5" cy="8.5" r="1.5"/><path d="m21 15-5-5L5 21"/></svg>`),
+    audio: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#f59e0b" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 18V5l12-2v13"/><circle cx="6" cy="18" r="3"/><circle cx="18" cy="16" r="3"/></svg>`),
+    mic: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#ef4444" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2a3 3 0 0 0-3 3v7a3 3 0 0 0 6 0V5a3 3 0 0 0-3-3Z"/><path d="M19 10v2a7 7 0 0 1-14 0v-2"/><line x1="12" x2="12" y1="19" y2="22"/></svg>`),
+    video: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#ec4899" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m22 8-6 4 6 4V8Z"/><rect x="2" y="6" width="14" height="12" rx="2"/></svg>`),
+    search: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#06b6d4" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/></svg>`),
+    info: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#06b6d4" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/></svg>`),
+    check: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#22c55e" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><path d="m9 11 3 3L22 4"/></svg>`),
+    rerank: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#a855f7" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="8" x2="21" y1="6" y2="6"/><line x1="8" x2="21" y1="12" y2="12"/><line x1="8" x2="21" y1="18" y2="18"/><line x1="3" x2="3.01" y1="6" y2="6"/><line x1="3" x2="3.01" y1="12" y2="12"/><line x1="3" x2="3.01" y1="18" y2="18"/></svg>`),
+    health: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#22c55e" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 12h-4l-3 9L9 3l-3 9H2"/></svg>`),
+    speaker: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#f97316" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polygon points="11 5 6 9 2 9 2 15 6 15 11 19 11 5"/><path d="M15.54 8.46a5 5 0 0 1 0 7.07"/><path d="M19.07 4.93a10 10 0 0 1 0 14.14"/></svg>`),
+    poll: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#64748b" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2v4"/><path d="m16.2 7.8 2.9-2.9"/><path d="M18 12h4"/><path d="m16.2 16.2 2.9 2.9"/><path d="M12 18v4"/><path d="m4.9 19.1 2.9-2.9"/><path d="M2 12h4"/><path d="m4.9 4.9 2.9 2.9"/></svg>`),
+};
+function icon(src) {
+    return [{ src, mimeType: 'image/svg+xml', sizes: ['24x24'] }];
+}
+/** Map of tool name → icons array for use in tool definitions. */
+export const TOOL_ICONS = {
+    chat_completion: icon(ICONS.chat),
+    start_chat_completion: icon(ICONS.chatAsync),
+    get_chat_completion_status: icon(ICONS.poll),
+    analyze_image: icon(ICONS.image),
+    analyze_audio: icon(ICONS.audio),
+    analyze_video: icon(ICONS.video),
+    search_models: icon(ICONS.search),
+    get_model_info: icon(ICONS.info),
+    validate_model: icon(ICONS.check),
+    generate_image: icon(ICONS.image),
+    generate_image_dedicated: icon(ICONS.image),
+    generate_audio: icon(ICONS.audio),
+    text_to_speech: icon(ICONS.speaker),
+    speech_to_text: icon(ICONS.mic),
+    generate_video: icon(ICONS.video),
+    generate_video_from_image: icon(ICONS.video),
+    get_video_status: icon(ICONS.poll),
+    rerank_documents: icon(ICONS.rerank),
+    health_check: icon(ICONS.health),
+};
+/** Server icon for use in the Server initialization metadata. */
+export const SERVER_ICON = [
+    {
+        src: svgDataUri(`<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 48 48" fill="none"><rect width="48" height="48" rx="12" fill="#1a1a2e"/><path d="M14 24h20M24 14v20" stroke="#6366f1" stroke-width="3" stroke-linecap="round"/><circle cx="24" cy="24" r="8" stroke="#22c55e" stroke-width="2"/><circle cx="24" cy="24" r="3" fill="#6366f1"/></svg>`),
+        mimeType: 'image/svg+xml',
+        sizes: ['48x48'],
+    },
+];

package/dist/version.d.ts

@@ -6,7 +6,7 @@
  * Bumped in lockstep with package.json / server.json / smithery.yaml /
  * scripts/build-manifest.mjs during release prep.
  */
-export declare const SERVER_VERSION = "4.6.0";
+export declare const SERVER_VERSION = "4.6.1";
 /**
  * MCP protocol version our SDK speaks. Hardcoded to match the version
  * bundled with `@modelcontextprotocol/sdk`; update when upgrading the

package/dist/version.js

@@ -6,7 +6,7 @@
  * Bumped in lockstep with package.json / server.json / smithery.yaml /
  * scripts/build-manifest.mjs during release prep.
  */
-export const SERVER_VERSION = '4.6.0';
+export const SERVER_VERSION = '4.6.1';
 /**
  * MCP protocol version our SDK speaks. Hardcoded to match the version
  * bundled with `@modelcontextprotocol/sdk`; update when upgrading the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stabgan/openrouter-mcp-multimodal",
-  "version": "4.6.0",
+  "version": "4.6.1",
   "mcpName": "io.github.stabgan/openrouter-multimodal",
   "description": "MCP server for OpenRouter — chat with 300+ LLMs, analyze images/audio/video, generate images (dedicated API), TTS/STT, video generation (Veo 3.1 / Seedance / Wan), async completions, response caching",
   "type": "module",