opik-mcp 2.0.0 → 2.0.2

package/build/tools/registration.js

@@ -1,6 +1,7 @@
 import { runWithRequestContext } from '../utils/request-context.js';
 import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
 import config from '../config.js';
+import { DEPRECATION_DESCRIPTION_SUFFIX, DEPRECATION_RESPONSE_BLOCK, } from '../utils/deprecation.js';
 const MISSING_API_KEY_MESSAGE = [
     'This Opik MCP request requires an API key.',
     'Set OPIK_API_KEY in the environment where the server runs,',
@@ -11,7 +12,7 @@ const MISSING_API_KEY_MESSAGE = [
 function inferAnnotations(name) {
     const readPrefixes = ['get-', 'list-', 'search-', 'read-'];
     const mutatePrefixes = ['create-', 'delete-', 'update-', 'add-', 'save-'];
-    if (readPrefixes.some(prefix => name.startsWith(prefix))) {
+    if (readPrefixes.some((prefix) => name.startsWith(prefix))) {
         return {
             readOnlyHint: true,
             destructiveHint: false,
@@ -19,7 +20,7 @@ function inferAnnotations(name) {
             openWorldHint: false,
         };
     }
-    if (mutatePrefixes.some(prefix => name.startsWith(prefix))) {
+    if (mutatePrefixes.some((prefix) => name.startsWith(prefix))) {
         return {
             readOnlyHint: false,
             destructiveHint: name.startsWith('delete-'),
@@ -33,7 +34,7 @@ function withRequestContext(handler, requiresApiKey = true) {
     return (...args) => {
         const extra = [...args]
             .reverse()
-            .find(arg => arg && typeof arg === 'object' && 'authInfo' in arg);
+            .find((arg) => arg && typeof arg === 'object' && 'authInfo' in arg);
         const authInfo = extra?.authInfo;
         const context = {
             apiKey: authInfo?.token,
@@ -52,8 +53,32 @@ function withRequestContext(handler, requiresApiKey = true) {
         return runWithRequestContext(context, () => handler(...args));
     };
 }
+/**
+ * Append a deprecation notice to every tool response. The block is
+ * pushed at the END of ``content`` (not the front) so existing tests
+ * that read ``content[0]`` keep passing and the LLM still surfaces it
+ * via recency. Defensive: only mutates results whose shape matches the
+ * MCP tool-call protocol ({ content: [...] }); anything else is
+ * returned untouched.
+ */
+function withDeprecationNotice(handler) {
+    return async (...args) => {
+        const result = await handler(...args);
+        if (result &&
+            typeof result === 'object' &&
+            Array.isArray(result.content)) {
+            const typed = result;
+            return {
+                ...result,
+                content: [...typed.content, DEPRECATION_RESPONSE_BLOCK],
+            };
+        }
+        return result;
+    };
+}
 export function registerTool(server, name, description, inputSchema, handler, options = {}) {
-    const wrappedHandler = withRequestContext(handler, options.requiresApiKey !== false);
+    const taggedDescription = description + DEPRECATION_DESCRIPTION_SUFFIX;
+    const wrappedHandler = withDeprecationNotice(withRequestContext(handler, options.requiresApiKey !== false));
     if (typeof server.registerTool === 'function') {
         const inferredAnnotations = inferAnnotations(name);
         const mergedAnnotations = {
@@ -62,15 +87,17 @@ export function registerTool(server, name, description, inputSchema, handler, op
         };
         server.registerTool(name, {
             ...(options.title && { title: options.title }),
-            description,
+            description: taggedDescription,
             inputSchema,
-            ...(Object.keys(mergedAnnotations).length > 0 && { annotations: mergedAnnotations }),
+            ...(Object.keys(mergedAnnotations).length > 0 && {
+                annotations: mergedAnnotations,
+            }),
             ...(options.outputSchema && { outputSchema: options.outputSchema }),
             ...(options._meta && { _meta: options._meta }),
         }, wrappedHandler);
         return;
     }
-    server.tool(name, description, inputSchema, wrappedHandler);
+    server.tool(name, taggedDescription, inputSchema, wrappedHandler);
 }
 export function registerResource(server, name, uri, description, readCallback) {
     const wrappedReadCallback = withRequestContext(readCallback);
@@ -84,7 +111,9 @@ export function registerResource(server, name, uri, description, readCallback) {
 }
 export function registerResourceTemplate(server, name, uriTemplate, description, readCallback, listCallback) {
     const wrappedReadCallback = withRequestContext(readCallback);
-    const wrappedListCallback = listCallback ? withRequestContext(listCallback) : undefined;
+    const wrappedListCallback = listCallback
+        ? withRequestContext(listCallback)
+        : undefined;
     const template = new ResourceTemplate(uriTemplate, {
         list: wrappedListCallback,
     });

package/build/tools/schema.js

@@ -1,6 +1,17 @@
 import { z } from 'zod';
-export const pageSchema = z.number().int().min(1).default(1).describe('1-based page number.');
-export const sizeSchema = (defaultSize, max = 100) => z.number().int().min(1).max(max).default(defaultSize).describe(`Page size (1-${max}).`);
+export const pageSchema = z
+    .number()
+    .int()
+    .min(1)
+    .default(1)
+    .describe('1-based page number.');
+export const sizeSchema = (defaultSize, max = 100) => z
+    .number()
+    .int()
+    .min(1)
+    .max(max)
+    .default(defaultSize)
+    .describe(`Page size (1-${max}).`);
 export const workspaceNameSchema = z
     .string()
     .min(1)

package/build/tools/trace.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { buildTraceFilters, callSdk, getOpikApi, getRequestOptions, resolveProjectIdentifier, } from '../utils/opik-sdk.js';
 import { registerTool } from './registration.js';
-import { isoDateSchema, pageSchema, sizeSchema, workspaceNameSchema } from './schema.js';
+import { isoDateSchema, pageSchema, sizeSchema, workspaceNameSchema, } from './schema.js';
 export const loadTraceTools = (server, options = {}) => {
     const { includeCoreTools = true, includeExpertActions = true } = options;
     if (includeCoreTools) {
@@ -18,7 +18,7 @@ export const loadTraceTools = (server, options = {}) => {
                 .describe('Optional project name (alternative to projectId).'),
             workspaceName: workspaceNameSchema,
         }, async (args) => {
-            const { page = 1, size = 10, projectId, projectName, workspaceName } = args;
+            const { page = 1, size = 10, projectId, projectName, workspaceName, } = args;
             const resolved = await resolveProjectIdentifier(projectId, projectName, workspaceName);
             if (resolved.error) {
                 return {
@@ -30,11 +30,18 @@ export const loadTraceTools = (server, options = {}) => {
                 page,
                 size,
                 ...(resolved.projectId && { projectId: resolved.projectId }),
-                ...(resolved.projectName && { projectName: resolved.projectName }),
+                ...(resolved.projectName && {
+                    projectName: resolved.projectName,
+                }),
             }, getRequestOptions(workspaceName)));
             if (!response.data) {
                 return {
-                    content: [{ type: 'text', text: response.error || 'Failed to fetch traces' }],
+                    content: [
+                        {
+                            type: 'text',
+                            text: response.error || 'Failed to fetch traces',
+                        },
+                    ],
                 };
             }
             return {
@@ -67,7 +74,9 @@ export const loadTraceTools = (server, options = {}) => {
             const response = await callSdk(() => api.traces.getTraceById(traceId, getRequestOptions(workspaceName)));
             if (!response.data) {
                 return {
-                    content: [{ type: 'text', text: response.error || 'Failed to fetch trace' }],
+                    content: [
+                        { type: 'text', text: response.error || 'Failed to fetch trace' },
+                    ],
                 };
             }
             const formattedResponse = { ...response.data };
@@ -126,12 +135,19 @@ export const loadTraceTools = (server, options = {}) => {
             const api = getOpikApi();
             const response = await callSdk(() => api.traces.getTraceStats({
                 ...(resolved.projectId && { projectId: resolved.projectId }),
-                ...(resolved.projectName && { projectName: resolved.projectName }),
+                ...(resolved.projectName && {
+                    projectName: resolved.projectName,
+                }),
                 ...(filters && { filters }),
             }, getRequestOptions(workspaceName)));
             if (!response.data) {
                 return {
-                    content: [{ type: 'text', text: response.error || 'Failed to fetch trace statistics' }],
+                    content: [
+                        {
+                            type: 'text',
+                            text: response.error || 'Failed to fetch trace statistics',
+                        },
+                    ],
                 };
             }
             return {
@@ -156,8 +172,14 @@ export const loadTraceTools = (server, options = {}) => {
             },
         });
         registerTool(server, 'get-trace-threads', 'List trace threads (conversation/session groupings) or fetch one thread by ID.', {
-            projectId: z.string().optional().describe('Optional project ID filter.'),
-            projectName: z.string().optional().describe('Optional project name filter.'),
+            projectId: z
+                .string()
+                .optional()
+                .describe('Optional project ID filter.'),
+            projectName: z
+                .string()
+                .optional()
+                .describe('Optional project name filter.'),
             page: pageSchema,
             size: sizeSchema(10),
             threadId: z
@@ -178,17 +200,26 @@ export const loadTraceTools = (server, options = {}) => {
                 ? await callSdk(() => api.traces.getTraceThread({
                     threadId,
                     ...(resolved.projectId && { projectId: resolved.projectId }),
-                    ...(resolved.projectName && { projectName: resolved.projectName }),
+                    ...(resolved.projectName && {
+                        projectName: resolved.projectName,
+                    }),
                 }, getRequestOptions(workspaceName)))
                 : await callSdk(() => api.traces.getTraceThreads({
                     page: page || 1,
                     size: size || 10,
                     ...(resolved.projectId && { projectId: resolved.projectId }),
-                    ...(resolved.projectName && { projectName: resolved.projectName }),
+                    ...(resolved.projectName && {
+                        projectName: resolved.projectName,
+                    }),
                 }, getRequestOptions(workspaceName)));
             if (!response.data) {
                 return {
-                    content: [{ type: 'text', text: response.error || 'Failed to fetch trace threads' }],
+                    content: [
+                        {
+                            type: 'text',
+                            text: response.error || 'Failed to fetch trace threads',
+                        },
+                    ],
                 };
             }
             return {
@@ -217,8 +248,14 @@ export const loadTraceTools = (server, options = {}) => {
     }
     if (includeExpertActions) {
         registerTool(server, 'search-traces', 'Search traces with optional text query, structured filters, and sorting.', {
-            projectId: z.string().optional().describe('Optional project ID to constrain search.'),
-            projectName: z.string().optional().describe('Optional project name to constrain search.'),
+            projectId: z
+                .string()
+                .optional()
+                .describe('Optional project ID to constrain search.'),
+            projectName: z
+                .string()
+                .optional()
+                .describe('Optional project name to constrain search.'),
             query: z
                 .string()
                 .optional()
@@ -233,7 +270,11 @@ export const loadTraceTools = (server, options = {}) => {
                 .enum(['created_at', 'duration', 'name', 'status'])
                 .optional()
                 .describe('Optional sort field.'),
-            sortOrder: z.enum(['asc', 'desc']).optional().default('desc').describe('Sort direction.'),
+            sortOrder: z
+                .enum(['asc', 'desc'])
+                .optional()
+                .default('desc')
+                .describe('Sort direction.'),
             workspaceName: workspaceNameSchema,
         }, async (args) => {
             const { projectId, projectName, query, filters, page, size, sortBy, sortOrder, workspaceName, } = args;
@@ -250,13 +291,20 @@ export const loadTraceTools = (server, options = {}) => {
                 page: page || 1,
                 size: size || 10,
                 ...(resolved.projectId && { projectId: resolved.projectId }),
-                ...(resolved.projectName && { projectName: resolved.projectName }),
+                ...(resolved.projectName && {
+                    projectName: resolved.projectName,
+                }),
                 ...(sdkFilters && { filters: sdkFilters }),
                 ...(sorting && { sorting }),
             }, getRequestOptions(workspaceName)));
             if (!response.data) {
                 return {
-                    content: [{ type: 'text', text: response.error || 'Failed to search traces' }],
+                    content: [
+                        {
+                            type: 'text',
+                            text: response.error || 'Failed to search traces',
+                        },
+                    ],
                 };
             }
             return {
@@ -289,7 +337,10 @@ export const loadTraceTools = (server, options = {}) => {
                     .min(1)
                     .describe('Feedback metric name, e.g. relevance, accuracy, helpfulness.'),
                 value: z.number().finite().describe('Numeric score value.'),
-                reason: z.string().optional().describe('Optional reason for this score.'),
+                reason: z
+                    .string()
+                    .optional()
+                    .describe('Optional reason for this score.'),
                 source: z
                     .enum(['ui', 'sdk', 'online_scoring'])
                     .optional()

package/build/transports/streamable-http-transport.js

@@ -23,7 +23,7 @@ function parseCsvEnv(value) {
     }
     return value
         .split(',')
-        .map(part => part.trim())
+        .map((part) => part.trim())
         .filter(Boolean);
 }
 function isAccessLogEnabled() {
@@ -32,7 +32,10 @@ function isAccessLogEnabled() {
         return false;
     }
     const normalized = value.trim().toLowerCase();
-    return normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on';
+    return (normalized === '1' ||
+        normalized === 'true' ||
+        normalized === 'yes' ||
+        normalized === 'on');
 }
 function formatAccessLogLine(req, res, durationMs, hasAuthHeader) {
     const timestamp = new Date().toISOString();
@@ -54,7 +57,9 @@ function getMcpMethodFromRequest(req) {
     if (!method) {
         return {};
     }
-    const toolName = method === 'tools/call' && body.params && typeof body.params.name === 'string'
+    const toolName = method === 'tools/call' &&
+        body.params &&
+        typeof body.params.name === 'string'
         ? body.params.name
         : undefined;
     return { method, toolName };
@@ -120,7 +125,7 @@ export class StreamableHttpTransport {
         this.port = options.port || 3001;
         this.host = options.host || process.env.STREAMABLE_HTTP_HOST || '127.0.0.1';
         this.app = createMcpExpressApp({ host: this.host });
-        this.mcpTransport.onerror = error => {
+        this.mcpTransport.onerror = (error) => {
             logToFile(`Streamable HTTP transport error: ${error instanceof Error ? error.stack || error.message : String(error)}`);
         };
         const allowedOrigins = parseCsvEnv(process.env.STREAMABLE_HTTP_CORS_ORIGINS);
@@ -128,7 +133,12 @@ export class StreamableHttpTransport {
             this.app.use(cors({
                 origin: allowedOrigins,
                 methods: ['GET', 'POST', 'DELETE', 'OPTIONS'],
-                allowedHeaders: ['content-type', 'authorization', 'x-api-key', 'comet-workspace'],
+                allowedHeaders: [
+                    'content-type',
+                    'authorization',
+                    'x-api-key',
+                    'comet-workspace',
+                ],
                 credentials: false,
             }));
         }
@@ -151,7 +161,10 @@ export class StreamableHttpTransport {
             const response = { status: 'ok' };
             res.json(response);
         });
-        this.app.get(['/.well-known/oauth-protected-resource', '/.well-known/oauth-protected-resource/mcp'], (req, res) => {
+        this.app.get([
+            '/.well-known/oauth-protected-resource',
+            '/.well-known/oauth-protected-resource/mcp',
+        ], (req, res) => {
             const baseUrl = getBaseUrl(req);
             const metadata = {
                 resource: `${baseUrl}/mcp`,
@@ -166,7 +179,10 @@ export class StreamableHttpTransport {
             error: 'unsupported_auth_flow',
             message: 'OAuth authorization server endpoints are not implemented; authenticate with Authorization: Bearer <OPIK_API_KEY>.',
         };
-        this.app.get(['/.well-known/oauth-authorization-server', '/.well-known/openid-configuration'], (_req, res) => {
+        this.app.get([
+            '/.well-known/oauth-authorization-server',
+            '/.well-known/openid-configuration',
+        ], (_req, res) => {
             res.status(404).json(oauthNotSupportedResponse);
         });
         this.app.post('/register', (_req, res) => {
@@ -175,7 +191,8 @@ export class StreamableHttpTransport {
         this.app.all('/mcp', async (req, res) => {
             try {
                 const { method, toolName } = getMcpMethodFromRequest(req);
-                if (isRemoteAuthRequired() && !isMethodAllowedWithoutAuth(method || '', toolName)) {
+                if (isRemoteAuthRequired() &&
+                    !isMethodAllowedWithoutAuth(method || '', toolName)) {
                     const auth = authenticateRemoteRequest(req.headers);
                     if (!auth.ok) {
                         const errorResponse = {
@@ -282,7 +299,7 @@ export class StreamableHttpTransport {
         await this.mcpTransport.close();
         return new Promise((resolve, reject) => {
             if (this.server) {
-                this.server.close(err => {
+                this.server.close((err) => {
                     if (err) {
                         reject(err);
                         return;

package/build/utils/capabilities.js

@@ -132,7 +132,14 @@ export const opikCapabilities = {
             'Filter by trace type',
             'Basic text search in trace names',
         ],
-        filterOptions: ['project_id', 'project_name', 'start_date', 'end_date', 'name', 'type'],
+        filterOptions: [
+            'project_id',
+            'project_name',
+            'start_date',
+            'end_date',
+            'name',
+            'type',
+        ],
         schema: {
             trace: {
                 id: 'string',
@@ -320,11 +327,11 @@ export function getCapabilitiesDescription(config) {
         }
         description += `${key.charAt(0).toUpperCase() + key.slice(1)}:\n`;
         description += 'Features:\n';
-        cap.features.forEach(feature => {
+        cap.features.forEach((feature) => {
             description += `- ${feature}\n`;
         });
         description += '\nLimitations:\n';
-        cap.limitations.forEach(limitation => {
+        cap.limitations.forEach((limitation) => {
             description += `- ${limitation}\n`;
         });
         description += '\n';

package/build/utils/deprecation.js

@@ -0,0 +1,66 @@
+/**
+ * Single source of truth for the deprecation message surfaced by every
+ * channel (MCP ``instructions`` field, stderr banner, README, package
+ * description, future tool-result injection). Keep all wording here so
+ * the four channels never drift apart.
+ *
+ * The companion `legacy/typescript/DEPRECATED.md` declares the same EOL
+ * date — update both together if it changes.
+ */
+export const SUNSET_DATE = '2026-11-15';
+export const MIGRATION_URL = 'https://github.com/comet-ml/opik-mcp/blob/main/legacy/typescript/MIGRATION.md';
+const ONE_LINE = `[DEPRECATED] opik-mcp (npm) is deprecated. Migrate to: ` +
+    `uvx opik-mcp@latest — sunset ${SUNSET_DATE}.`;
+const SHORT = `The TypeScript Opik MCP server is deprecated and will stop ` +
+    `serving requests on ${SUNSET_DATE}. ` +
+    `Install the supported Python build with: uvx opik-mcp@latest`;
+const FULL = `\
+============================================================
+  ⚠️  opik-mcp (npm, TypeScript) is DEPRECATED
+============================================================
+
+This server stops serving MCP requests on ${SUNSET_DATE}.
+
+Migrate now — in your MCP client config, replace:
+
+  npx -y opik-mcp
+
+with:
+
+  uvx opik-mcp@latest
+
+The tool surface, env vars and transports have changed. Migration
+guide: ${MIGRATION_URL}
+
+============================================================`;
+export const DEPRECATION_NOTICE = {
+    oneLine: ONE_LINE,
+    short: SHORT,
+    full: FULL,
+    sunsetDate: SUNSET_DATE,
+    migrationUrl: MIGRATION_URL,
+};
+/**
+ * Short suffix appended to every tool ``description`` so the MCP host's
+ * tool palette shows the deprecation label inline. Kept brief — palette
+ * UIs in Claude / Cursor / VS Code truncate long descriptions. Not
+ * applied to resources/prompts: their descriptions surface less
+ * prominently and the stderr banner + ``instructions`` field already
+ * cover those surfaces.
+ */
+export const DEPRECATION_DESCRIPTION_SUFFIX = ` ⚠️ DEPRECATED — migrate to \`uvx opik-mcp@latest\` by ${SUNSET_DATE}`;
+/**
+ * Content block appended to every tool response. The host LLM reads
+ * tool outputs on every call, so this is the channel that survives
+ * sessions started before the upgrade and never reads logs/READMEs.
+ * Phrased as a server-to-assistant notice so the model surfaces it
+ * to the user instead of treating it as part of the tool payload.
+ */
+export const DEPRECATION_RESPONSE_BLOCK = {
+    type: 'text',
+    text: `[opik-mcp server notice] This TypeScript MCP server (npm) is ` +
+        `DEPRECATED and stops serving requests on ${SUNSET_DATE}. Please ` +
+        `tell the user to replace \`npx -y opik-mcp\` with ` +
+        `\`uvx opik-mcp@latest\` in their MCP client config. Migration ` +
+        `guide: ${MIGRATION_URL}`,
+};

package/build/utils/examples.js

@@ -391,7 +391,7 @@ export function getExampleForTask(task) {
         const keyWords = key.split('-');
         const taskWords = normalizedTask.split(/\s+/);
         // Check if all key words are in the task
-        const allWordsMatch = keyWords.every(word => taskWords.some(taskWord => taskWord.includes(word) || word.includes(taskWord)));
+        const allWordsMatch = keyWords.every((word) => taskWords.some((taskWord) => taskWord.includes(word) || word.includes(taskWord)));
         if (allWordsMatch) {
             return example;
         }
@@ -410,5 +410,5 @@ export function getExampleForTask(task) {
  * @returns Array of task titles
  */
 export function getAllExampleTasks() {
-    return Object.values(examples).map(example => example.title);
+    return Object.values(examples).map((example) => example.title);
 }

package/build/utils/opik-sdk.js

@@ -8,7 +8,10 @@ function getEffectiveApiKey() {
 }
 function getEffectiveWorkspaceName() {
     const context = getRequestContext();
-    return context?.workspaceName || config.workspaceName || config.mcpDefaultWorkspace || 'default';
+    return (context?.workspaceName ||
+        config.workspaceName ||
+        config.mcpDefaultWorkspace ||
+        'default');
 }
 function getOpikClient() {
     const apiKey = getEffectiveApiKey();
@@ -51,7 +54,9 @@ export async function resolveProjectIdentifier(projectId, projectName, workspace
         page: 1,
         size: 1,
     }, getRequestOptions(workspaceName)));
-    if (!response.data || !response.data.content || response.data.content.length === 0) {
+    if (!response.data ||
+        !response.data.content ||
+        response.data.content.length === 0) {
         return { error: response.error || 'No projects found' };
     }
     return { projectId: response.data.content[0].id };

package/build/utils/remote-auth.js

@@ -62,7 +62,9 @@ export function isMethodAllowedWithoutAuth(method, toolName) {
     if (ONBOARDING_ALLOWED_NO_AUTH_METHODS.has(method)) {
         return true;
     }
-    if (method === 'tools/call' && toolName && ONBOARDING_SAFE_TOOLS.has(toolName)) {
+    if (method === 'tools/call' &&
+        toolName &&
+        ONBOARDING_SAFE_TOOLS.has(toolName)) {
         return true;
     }
     return false;
@@ -157,7 +159,11 @@ export async function validateRemoteAuth(context) {
                 valid: false,
                 expiresAt: now + INVALID_CACHE_TTL_MS,
             });
-            return { ok: false, status: 401, message: 'Invalid API key or workspace.' };
+            return {
+                ok: false,
+                status: 401,
+                message: 'Invalid API key or workspace.',
+            };
         }
         return {
             ok: false,

package/build/utils/tracing-info.js

@@ -13,7 +13,13 @@ export function getTracingInfo(topic) {
         return {
             title: 'Opik Tracing Capabilities',
             description: 'Opik provides comprehensive tracing capabilities to help you understand and analyze your LLM applications. Traces capture the full context of LLM interactions, including inputs, outputs, and metadata.',
-            availableTopics: ['traces', 'spans', 'feedback', 'search', 'visualization'],
+            availableTopics: [
+                'traces',
+                'spans',
+                'feedback',
+                'search',
+                'visualization',
+            ],
         };
     }
     // Return information based on the requested topic

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opik-mcp",
-  "version": "2.0.0",
-  "description": "MCP server to interact with Opik - Enables automated prompt optimization",
+  "version": "2.0.2",
+  "description": "[DEPRECATED — use `uvx opik-mcp@latest` instead, sunset 2026-11-15] MCP server to interact with Opik - Enables automated prompt optimization",
   "type": "module",
   "bin": {
     "opik-mcp": "./build/cli.js"
@@ -50,12 +50,14 @@
   },
   "devDependencies": {
     "@jest/globals": "^30.2.0",
+    "@smithery/cli": "^4.1.8",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "@types/jest": "^30.0.0",
-    "@types/node": "^22.13.9",
+    "@types/node": "^25.3.3",
     "@typescript-eslint/eslint-plugin": "^7.4.0",
     "@typescript-eslint/parser": "^7.4.0",
+    "esbuild": "^0.27.3",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
@@ -78,7 +80,9 @@
         {
           "useESM": true,
           "diagnostics": {
-            "ignoreCodes": [151002]
+            "ignoreCodes": [
+              151002
+            ]
           }
         }
       ]