opik-mcp 2.0.0 → 2.0.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/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,6 +1,6 @@
 {
   "name": "opik-mcp",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "MCP server to interact with Opik - Enables automated prompt optimization",
   "type": "module",
   "bin": {
@@ -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",