@tigerdata/mcp-boilerplate 0.9.0 → 0.9.2

package/README.md

@@ -14,7 +14,7 @@ This provides some common code for creating a [Model Context Protocol](https://m
 2. Install dependencies:
 
    ```bash
-   npm install
+   ./bun install
    ```
 
 ## Eslint Plugin
@@ -45,7 +45,7 @@ export default [
 To build the TypeScript project:
 
 ```bash
-npm run build
+./bun run build
 ```
 
 This compiles the TypeScript files from `src/` to JavaScript in `dist/`.
@@ -55,7 +55,7 @@ This compiles the TypeScript files from `src/` to JavaScript in `dist/`.
 To run TypeScript compilation in watch mode (rebuilds on file changes):
 
 ```bash
-npm run watch
+./bun run watch
 ```
 
 ### Linting
@@ -65,13 +65,13 @@ This project uses ESLint for code linting with TypeScript support.
 To run the linter:
 
 ```bash
-npm run lint
+./bun run lint
 ```
 
 To automatically fix linting issues where possible:
 
 ```bash
-npm run lint:fix
+./bun run lint --write
 ```
 
 ### Continuous Integration

package/dist/cliEntrypoint.js

@@ -1,4 +1,4 @@
-import { join } from 'path';
+import { join } from 'node:path';
 export async function cliEntrypoint(stdioEntrypoint, httpEntrypoint, instrumentation = join(import.meta.dir, './instrumentation.js')) {
     // Parse command line arguments first
     const args = process.argv.slice(2);

package/dist/eslintPlugin.js

@@ -34,11 +34,15 @@ const noOptionalInputSchema = {
             VariableDeclarator(node) {
                 const varNode = node;
                 // Check if this variable has a TypeScript type annotation
-                if (varNode.id?.typeAnnotation?.typeAnnotation) {
-                    const typeAnn = varNode.id.typeAnnotation.typeAnnotation;
+                if (varNode.id &&
+                    varNode.id.typeAnnotation?.typeAnnotation) {
+                    const typeAnn = varNode.id.typeAnnotation
+                        ?.typeAnnotation;
                     // Look for ApiFactory type reference
-                    if (typeAnn.type === 'TSTypeReference' &&
-                        typeAnn.typeName?.name === 'ApiFactory') {
+                    if (typeAnn?.type === 'TSTypeReference' &&
+                        typeAnn.typeName &&
+                        'name' in typeAnn.typeName &&
+                        typeAnn.typeName.name === 'ApiFactory') {
                         // Get the type parameters
                         const typeParams = typeAnn.typeArguments?.params;
                         if (typeParams && typeParams.length >= 2) {
@@ -100,7 +104,6 @@ function isInsideApiFactoryInputSchema(node, context, apiFactoryInputSchemas) {
             }
         }
     }
-    // Fallback: walk up parent chain if node.parent is available
     let current = node.parent;
     while (current) {
         // Variable that's an ApiFactory input schema

package/dist/http/api.d.ts

@@ -1,5 +1,5 @@
 /**
  * REST API alternative to MCP for direct use of the same tools.
  */
-import { ApiFactory, RouterFactoryResult } from '../types.js';
-export declare const apiRouterFactory: <Context extends Record<string, unknown>>(context: Context, apiFactories: readonly ApiFactory<Context, any, any>[]) => RouterFactoryResult;
+import type { BaseApiFactory, RouterFactoryResult } from '../types.js';
+export declare const apiRouterFactory: <Context extends Record<string, unknown>>(context: Context, apiFactories: readonly BaseApiFactory<Context>[]) => RouterFactoryResult;

package/dist/http/api.js

@@ -1,8 +1,8 @@
 /**
  * REST API alternative to MCP for direct use of the same tools.
  */
-import { Router } from 'express';
 import bodyParser from 'body-parser';
+import { Router } from 'express';
 import { z } from 'zod';
 export const apiRouterFactory = (context, apiFactories) => {
     const router = Router();

package/dist/http/mcp.d.ts

@@ -1,8 +1,9 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { RouterFactoryResult, McpFeatureFlags } from '../types.js';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpFeatureFlags, RouterFactoryResult } from '../types.js';
 export declare const mcpRouterFactory: <Context extends Record<string, unknown>>(context: Context, createServer: (context: Context, featureFlags: McpFeatureFlags) => {
     server: McpServer;
-}, { name, stateful, }?: {
+}, { name, stateful, inspector, }?: {
     name?: string;
     stateful?: boolean;
+    inspector?: boolean;
 }) => RouterFactoryResult;

package/dist/http/mcp.js

@@ -1,14 +1,14 @@
-import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { randomUUID } from 'node:crypto';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import { trace, context as otelContext, propagation, SpanKind, SpanStatusCode, } from '@opentelemetry/api';
+import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { context as otelContext, propagation, SpanKind, SpanStatusCode, trace, } from '@opentelemetry/api';
 import { ATTR_HTTP_RESPONSE_STATUS_CODE } from '@opentelemetry/semantic-conventions';
 import { Router } from 'express';
-import { randomUUID } from 'node:crypto';
 import getRawBody from 'raw-body';
 import { log } from '../logger.js';
 const name = process.env.OTEL_SERVICE_NAME;
 const tracer = trace.getTracer(name ? `${name}.router.mcp` : 'router.mcp');
-export const mcpRouterFactory = (context, createServer, { name, stateful = true, } = {}) => {
+export const mcpRouterFactory = (context, createServer, { name, stateful = true, inspector = false, } = {}) => {
     const router = Router();
     const transports = new Map();
     const sessionFeatureFlags = new Map();
@@ -49,7 +49,8 @@ export const mcpRouterFactory = (context, createServer, { name, stateful = true,
         let transport;
         let body = req.body;
         if (sessionId) {
-            if (!transports.has(sessionId)) {
+            const t = transports.get(sessionId);
+            if (!t) {
                 res.status(404).json({
                     jsonrpc: '2.0',
                     error: {
@@ -60,7 +61,7 @@ export const mcpRouterFactory = (context, createServer, { name, stateful = true,
                 });
                 return;
             }
-            transport = transports.get(sessionId);
+            transport = t;
         }
         else {
             if (!body) {
@@ -177,7 +178,7 @@ export const mcpRouterFactory = (context, createServer, { name, stateful = true,
             });
             return;
         }
-        await transports.get(sessionId).handleRequest(req, res);
+        await transports.get(sessionId)?.handleRequest(req, res);
     };
     // Handle GET requests for server-to-client notifications via SSE
     router.get('/', (req, res) => {
@@ -197,7 +198,11 @@ export const mcpRouterFactory = (context, createServer, { name, stateful = true,
   <h1>${name}</h1>
   <h2>Model Context Protocol (MCP) Server</h2>
   <p>This endpoint is used for MCP communication. Please use an MCP-compatible client to interact with this server.</p>
-
+  ${inspector
+                ? `
+  <h3>Inspector</h3>
+  <p>You can use the <a href="/inspector">MCP Inspector</a> for testing purposes.</p>`
+                : ''}
   <h3>Claude Code</h3>
   <p>To connect to this MCP server using Claude Code, run the following command in your terminal:</p>
   <pre><code>claude mcp add --transport http ${name || req.get('host')} ${fullUrl}</code></pre>
@@ -214,7 +219,7 @@ export const mcpRouterFactory = (context, createServer, { name, stateful = true,
         for (const sessionId in transports) {
             try {
                 log.info(`Closing transport for session ${sessionId}`);
-                await transports.get(sessionId).close();
+                await transports.get(sessionId)?.close();
                 transports.delete(sessionId);
             }
             catch (error) {

package/dist/httpServer.d.ts

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
+import type { Server } from 'node:http';
 import express from 'express';
-import { ApiFactory, PromptFactory, ResourceFactory } from './types.js';
-import { AdditionalSetupArgs } from './mcpServer.js';
-import { Server } from 'node:http';
+import { type AdditionalSetupArgs } from './mcpServer.js';
+import type { BaseApiFactory, BasePromptFactory, ResourceFactory } from './types.js';
 export declare const httpServerFactory: <Context extends Record<string, unknown>>({ name, version, context, apiFactories, promptFactories, resourceFactories, additionalSetup, cleanupFn, stateful, instructions, }: {
     name: string;
     version?: string;
     context: Context;
-    apiFactories?: readonly ApiFactory<Context, any, any>[];
-    promptFactories?: readonly PromptFactory<Context, any>[];
+    apiFactories?: readonly BaseApiFactory<Context>[];
+    promptFactories?: readonly BasePromptFactory<Context>[];
     resourceFactories?: readonly ResourceFactory<Context>[];
     additionalSetup?: (args: AdditionalSetupArgs<Context>) => void;
     cleanupFn?: () => void | Promise<void>;

package/dist/httpServer.js

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
+import bodyParser from 'body-parser';
 import express from 'express';
-import { mcpRouterFactory } from './http/mcp.js';
 import { apiRouterFactory } from './http/api.js';
-import { registerExitHandlers } from './registerExitHandlers.js';
-import { mcpServerFactory } from './mcpServer.js';
+import { mcpRouterFactory } from './http/mcp.js';
 import { log } from './logger.js';
+import { mcpServerFactory } from './mcpServer.js';
+import { registerExitHandlers } from './registerExitHandlers.js';
 import { StatusError } from './StatusError.js';
 export const httpServerFactory = ({ name, version, context, apiFactories = [], promptFactories, resourceFactories, additionalSetup, cleanupFn, stateful = true, instructions, }) => {
     const cleanupFns = cleanupFn
@@ -14,6 +15,9 @@ export const httpServerFactory = ({ name, version, context, apiFactories = [], p
     log.info('Starting HTTP server...');
     const app = express();
     app.enable('trust proxy');
+    const PORT = process.env.PORT || 3001;
+    const inspector = process.env.NODE_ENV !== 'production' ||
+        ['1', 'true'].includes(process.env.ENABLE_INSPECTOR ?? '0');
     const [mcpRouter, mcpCleanup] = mcpRouterFactory(context, (context, featureFlags) => mcpServerFactory({
         name,
         version,
@@ -24,14 +28,14 @@ export const httpServerFactory = ({ name, version, context, apiFactories = [], p
         additionalSetup,
         featureFlags,
         instructions,
-    }), { name, stateful });
+    }), { name, stateful, inspector });
     cleanupFns.push(mcpCleanup);
     app.use('/mcp', mcpRouter);
     const [apiRouter, apiCleanup] = apiRouterFactory(context, apiFactories);
     cleanupFns.push(apiCleanup);
     app.use('/api', apiRouter);
     // Error handler
-    app.use(function (err, req, res, _next) {
+    app.use((err, _req, res, _next) => {
         if (err instanceof StatusError && err.status < 500) {
             log.info('HTTP error response', {
                 message: err.message,
@@ -45,15 +49,26 @@ export const httpServerFactory = ({ name, version, context, apiFactories = [], p
             .status(err instanceof StatusError ? err.status : 500)
             .json({ error: err.message });
     });
+    if (inspector) {
+        process.env.MCP_USE_ANONYMIZED_TELEMETRY = 'false';
+        import('@mcp-use/inspector')
+            .then(({ mountInspector }) => {
+            app.use(bodyParser.json());
+            mountInspector(app, { autoConnectUrl: `http://localhost:${PORT}/mcp` });
+        })
+            .catch(log.error);
+    }
     // Start the server
-    const PORT = process.env.PORT || 3001;
-    const server = app.listen(PORT, (error) => {
+    const server = app.listen(PORT, async (error) => {
         if (error) {
             log.error('Error starting HTTP server:', error);
             exitHandler(1);
         }
         else {
             log.info(`HTTP Server listening on port ${PORT}`);
+            if (inspector) {
+                log.info(`🌐 MCP inspector running at http://localhost:${PORT}/inspector`);
+            }
         }
     });
     cleanupFns.push(async () => {

package/dist/index.d.ts

@@ -1,10 +1,9 @@
 export { cliEntrypoint } from './cliEntrypoint.js';
 export { httpServerFactory } from './httpServer.js';
 export { log } from './logger.js';
-export { stdioServerFactory } from './stdio.js';
-export type { ApiFactory, McpFeatureFlags, PromptFactory, ResourceFactory, ParsedQs, } from './types.js';
-export { StatusError } from './StatusError.js';
 export type { AdditionalSetupArgs } from './mcpServer.js';
-export { withSpan, addAiResultToSpan } from './tracing.js';
 export { registerExitHandlers } from './registerExitHandlers.js';
-export type { InferSchema } from './types.js';
+export { StatusError } from './StatusError.js';
+export { stdioServerFactory } from './stdio.js';
+export { addAiResultToSpan, withSpan } from './tracing.js';
+export type { ApiFactory, InferSchema, McpFeatureFlags, ParsedQs, PromptFactory, ResourceFactory, } from './types.js';

package/dist/index.js

@@ -1,7 +1,7 @@
 export { cliEntrypoint } from './cliEntrypoint.js';
 export { httpServerFactory } from './httpServer.js';
 export { log } from './logger.js';
-export { stdioServerFactory } from './stdio.js';
-export { StatusError } from './StatusError.js';
-export { withSpan, addAiResultToSpan } from './tracing.js';
 export { registerExitHandlers } from './registerExitHandlers.js';
+export { StatusError } from './StatusError.js';
+export { stdioServerFactory } from './stdio.js';
+export { addAiResultToSpan, withSpan } from './tracing.js';

package/dist/instrumentation.d.ts

@@ -1,6 +1,6 @@
-import { NodeSDK } from '@opentelemetry/sdk-node';
-import { InstrumentationConfigMap } from '@opentelemetry/auto-instrumentations-node';
+import { type InstrumentationConfigMap } from '@opentelemetry/auto-instrumentations-node';
 import type { Instrumentation } from '@opentelemetry/instrumentation';
+import { NodeSDK } from '@opentelemetry/sdk-node';
 interface Options {
     environment?: string;
     instrumentations?: Instrumentation[];

package/dist/instrumentation.js

@@ -1,11 +1,11 @@
-import { NodeSDK } from '@opentelemetry/sdk-node';
-import { resourceFromAttributes } from '@opentelemetry/resources';
+import { getNodeAutoInstrumentations, } from '@opentelemetry/auto-instrumentations-node';
+import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
 import { OTLPTraceExporter as GrpcTraceExporter } from '@opentelemetry/exporter-trace-otlp-grpc';
 import { OTLPTraceExporter as HttpTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
-import { getNodeAutoInstrumentations, } from '@opentelemetry/auto-instrumentations-node';
-import { BatchSpanProcessor, } from '@opentelemetry/sdk-trace-base';
+import { resourceFromAttributes } from '@opentelemetry/resources';
 import { BatchLogRecordProcessor, } from '@opentelemetry/sdk-logs';
-import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { BatchSpanProcessor, } from '@opentelemetry/sdk-trace-base';
 import { log } from './logger.js';
 export const instrument = (options = {}) => {
     const spanProcessors = [];

package/dist/logger.d.ts

@@ -1,4 +1,4 @@
-import { LogAttributes } from '@opentelemetry/api-logs';
+import { type LogAttributes } from '@opentelemetry/api-logs';
 interface LogInterface {
     debug: (body: string, attributes?: LogAttributes) => void;
     info: (body: string, attributes?: LogAttributes) => void;

package/dist/logger.js

@@ -1,4 +1,4 @@
-import { logs, SeverityNumber } from '@opentelemetry/api-logs';
+import { logs, SeverityNumber, } from '@opentelemetry/api-logs';
 const name = process.env.OTEL_SERVICE_NAME || 'mcp-app';
 const logger = logs.getLogger(name);
 // Helper functions to replace console.log

package/dist/mcpServer.d.ts

@@ -1,6 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { ApiFactory, PromptFactory, McpFeatureFlags, ResourceFactory } from './types.js';
-import { ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
+import type { ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
+import type { BaseApiFactory, BasePromptFactory, McpFeatureFlags, ResourceFactory } from './types.js';
 export interface AdditionalSetupArgs<Context extends Record<string, unknown>> {
     context: Context;
     server: McpServer;
@@ -10,8 +10,8 @@ export declare const mcpServerFactory: <Context extends Record<string, unknown>>
     name: string;
     version?: string;
     context: Context;
-    apiFactories?: readonly ApiFactory<Context, any, any>[];
-    promptFactories?: readonly PromptFactory<Context, any>[];
+    apiFactories?: readonly BaseApiFactory<Context>[];
+    promptFactories?: readonly BasePromptFactory<Context>[];
     resourceFactories?: readonly ResourceFactory<Context>[];
     additionalSetup?: (args: AdditionalSetupArgs<Context>) => void;
     additionalCapabilities?: ServerCapabilities;

package/dist/mcpServer.js

@@ -1,5 +1,5 @@
 import { McpServer, ResourceTemplate, } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { SpanStatusCode, trace, context as otelContext, propagation, SpanKind, } from '@opentelemetry/api';
+import { context as otelContext, propagation, SpanKind, SpanStatusCode, trace, } from '@opentelemetry/api';
 import { log } from './logger.js';
 const name = process.env.OTEL_SERVICE_NAME;
 const tracer = trace.getTracer(name ? `${name}.mcpServer` : 'mcpServer');
@@ -19,7 +19,7 @@ const shouldSkip = (item, enabledSets, disabledSets) => {
         }
     }
     for (const disabledSet of disabledSets) {
-        if (disabledSet && disabledSet.has(item.name)) {
+        if (disabledSet?.has(item.name)) {
             return true;
         }
     }
@@ -59,7 +59,7 @@ export const mcpServerFactory = ({ name, version = '1.0.0', context, apiFactorie
                     // make sense.
                     title: tool.config.title,
                 },
-            }, async (args, extra) => {
+            }, (async (args, extra) => {
                 let traceContext = otelContext.active();
                 if (extra?._meta?.traceparent) {
                     // Some MCP clients (e.g. pydantic) pass the parent trace context
@@ -106,7 +106,7 @@ export const mcpServerFactory = ({ name, version = '1.0.0', context, apiFactorie
                         span.end();
                     }
                 });
-            });
+            }));
         }
     }
     if (enablePrompts) {
@@ -173,6 +173,9 @@ export const mcpServerFactory = ({ name, version = '1.0.0', context, apiFactorie
                         list: resource.list &&
                             ((extra) => tracer.startActiveSpan(`mcp.resource.templated.${resource.name}.list`, async (span) => {
                                 try {
+                                    if (!resource.list) {
+                                        throw new Error('resource.list is not defined');
+                                    }
                                     const result = await resource.list(extra);
                                     span.setAttribute('mcp.resource.list.uris', result.resources.map((r) => r.uri).join(', '));
                                     span.setStatus({ code: SpanStatusCode.OK });

package/dist/stdio.d.ts

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { ApiFactory, PromptFactory, ResourceFactory } from './types.js';
-import { AdditionalSetupArgs } from './mcpServer.js';
+import { type AdditionalSetupArgs } from './mcpServer.js';
+import type { BaseApiFactory, BasePromptFactory, ResourceFactory } from './types.js';
 export declare const stdioServerFactory: <Context extends Record<string, unknown>>({ name, version, context, apiFactories, promptFactories, resourceFactories, additionalSetup, cleanupFn, instructions, }: {
     name: string;
     version?: string;
     context: Context;
-    apiFactories?: readonly ApiFactory<Context, any, any>[];
-    promptFactories?: readonly PromptFactory<Context, any>[];
+    apiFactories?: readonly BaseApiFactory<Context>[];
+    promptFactories?: readonly BasePromptFactory<Context>[];
     resourceFactories?: readonly ResourceFactory<Context>[];
     additionalSetup?: (args: AdditionalSetupArgs<Context>) => void;
     cleanupFn?: () => Promise<void>;

package/dist/tracing.d.ts

@@ -1,4 +1,4 @@
 import { type Span, type Tracer } from '@opentelemetry/api';
-import type { GenerateTextResult, ModelMessage } from 'ai';
+import type { GenerateTextResult, ModelMessage, ToolSet } from 'ai';
 export declare const withSpan: <T>(tracer: Tracer, name: string, fn: (span: Span) => Promise<T>) => Promise<T>;
-export declare const addAiResultToSpan: (span: Span, aiResult: GenerateTextResult<any, unknown>, inputMessages: ModelMessage[]) => void;
+export declare const addAiResultToSpan: (span: Span, aiResult: GenerateTextResult<ToolSet, unknown>, inputMessages: ModelMessage[]) => void;

package/dist/types.d.ts

@@ -1,23 +1,47 @@
-import { z } from 'zod';
-import type { ZodRawShape, ZodTypeAny } from 'zod';
-import type { ToolAnnotations, GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
-import { Router } from 'express';
-import { CompleteResourceTemplateCallback, ListResourcesCallback, ReadResourceCallback, ReadResourceTemplateCallback, ResourceMetadata } from '@modelcontextprotocol/sdk/server/mcp.js';
-export type ToolConfig<InputArgs extends ZodRawShape, OutputArgs extends ZodRawShape> = {
+import type { CompleteResourceTemplateCallback, ListResourcesCallback, ReadResourceCallback, ReadResourceTemplateCallback, ResourceMetadata } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { GetPromptResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+import type { Router } from 'express';
+import type { ZodRawShape, ZodTypeAny, z } from 'zod';
+export type BaseToolConfig = {
     title?: string;
     description?: string;
-    inputSchema: InputArgs;
-    outputSchema: OutputArgs;
+    inputSchema: ZodRawShape;
+    outputSchema: ZodRawShape;
     annotations?: ToolAnnotations;
 };
-export interface ApiDefinition<InputArgs extends ZodRawShape, OutputArgs extends ZodRawShape, SimplifiedOutputArgs = OutputArgs> {
+export interface BaseApiDefinition {
     name: string;
     method?: 'get' | 'post' | 'put' | 'delete';
     route?: string | string[];
-    config: ToolConfig<InputArgs, OutputArgs>;
+    config: BaseToolConfig;
     disabled?: boolean;
-    fn: (args: z.objectOutputType<InputArgs, ZodTypeAny>) => Promise<z.objectOutputType<OutputArgs, ZodTypeAny>>;
-    pickResult?: (result: z.objectOutputType<OutputArgs, ZodTypeAny>) => SimplifiedOutputArgs;
+    fn(args: Record<string, unknown>): Promise<Record<string, unknown>>;
+    pickResult?(result: Record<string, unknown>): unknown;
+}
+export type BaseApiFactory<Context extends Record<string, unknown>> = (ctx: Context, featureFlags: McpFeatureFlags) => BaseApiDefinition;
+export type BasePromptConfig = {
+    title?: string;
+    description?: string;
+    inputSchema: ZodRawShape;
+};
+export interface BasePromptDefinition {
+    name: string;
+    config: BasePromptConfig;
+    disabled?: boolean;
+    fn(args: Record<string, unknown>): Promise<GetPromptResult>;
+}
+export type BasePromptFactory<Context extends Record<string, unknown>> = (ctx: Context, featureFlags: McpFeatureFlags) => BasePromptDefinition;
+export type ToolConfig<InputArgs extends ZodRawShape, OutputArgs extends ZodRawShape> = {
+    title?: string;
+    description?: string;
+    inputSchema: InputArgs;
+    outputSchema: OutputArgs;
+    annotations?: ToolAnnotations;
+};
+export interface ApiDefinition<InputArgs extends ZodRawShape, OutputArgs extends ZodRawShape, SimplifiedOutputArgs = OutputArgs> extends BaseApiDefinition {
+    config: ToolConfig<InputArgs, OutputArgs>;
+    fn(args: z.objectOutputType<InputArgs, ZodTypeAny>): Promise<z.objectOutputType<OutputArgs, ZodTypeAny>>;
+    pickResult?(result: z.objectOutputType<OutputArgs, ZodTypeAny>): SimplifiedOutputArgs;
 }
 export type ApiFactory<Context extends Record<string, unknown>, Input extends ZodRawShape, Output extends ZodRawShape, RestOutput = Output> = (ctx: Context, featureFlags: McpFeatureFlags) => ApiDefinition<Input, Output, RestOutput>;
 export type RouterFactoryResult = [Router, () => void | Promise<void>];
@@ -26,11 +50,9 @@ export type PromptConfig<InputArgs extends ZodRawShape> = {
     description?: string;
     inputSchema: InputArgs;
 };
-export interface PromptDefinition<InputArgs extends ZodRawShape> {
-    name: string;
+export interface PromptDefinition<InputArgs extends ZodRawShape> extends BasePromptDefinition {
     config: PromptConfig<InputArgs>;
-    disabled?: boolean;
-    fn: (args: z.objectOutputType<InputArgs, ZodTypeAny>) => Promise<GetPromptResult>;
+    fn(args: z.objectOutputType<InputArgs, ZodTypeAny>): Promise<GetPromptResult>;
 }
 export type PromptFactory<Context extends Record<string, unknown>, Input extends ZodRawShape> = (ctx: Context, featureFlags: McpFeatureFlags) => PromptDefinition<Input>;
 export interface TemplatedResourceDefinition {

package/dist/types.spec.js

@@ -1,4 +1,4 @@
-import { describe, it, expect, expectTypeOf } from 'bun:test';
+import { describe, expect, expectTypeOf, it } from 'bun:test';
 import { z } from 'zod';
 describe('InferSchema', () => {
     it('should infer required properties correctly', () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tigerdata/mcp-boilerplate",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "MCP boilerplate code for Node.js",
   "license": "Apache-2.0",
   "author": "TigerData",
@@ -31,17 +31,15 @@
   ],
   "scripts": {
     "build": "tsc",
-    "prepare": "npm run build",
+    "prepublishOnly": "tsc",
     "watch": "tsc --watch",
-    "lint": "eslint",
-    "lint:fix": "eslint --fix",
-    "prettier:write": "prettier --write .",
-    "prettier:check": "prettier --check ."
+    "lint": "./bun x @biomejs/biome check"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.24.2",
+    "@mcp-use/inspector": "^0.13.2",
+    "@modelcontextprotocol/sdk": "^1.25.1",
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/auto-instrumentations-node": "^0.67.2",
+    "@opentelemetry/auto-instrumentations-node": "^0.67.3",
     "@opentelemetry/exporter-trace-otlp-grpc": "^0.208.0",
     "@opentelemetry/instrumentation-http": "^0.208.0",
     "@opentelemetry/sdk-metrics": "^2.2.0",
@@ -53,15 +51,14 @@
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.1",
-    "@types/bun": "^1.3.3",
+    "@biomejs/biome": "^2.3.10",
+    "@types/bun": "^1.3.5",
     "@types/express": "^5.0.6",
-    "@types/node": "^22.19.1",
-    "ai": "^5.0.106",
-    "eslint": "^9.39.1",
-    "prettier": "^3.7.4",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.48.1"
+    "@types/node": "^22.19.3",
+    "@typescript-eslint/typescript-estree": "^8.50.0",
+    "ai": "^5.0.115",
+    "eslint": "^9.39.2",
+    "typescript": "^5.9.3"
   },
   "publishConfig": {
     "access": "public"