@tigerdata/mcp-boilerplate 0.9.0 → 0.9.1

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,6 @@
 /**
  * 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 ZodRawShape } from 'zod';
+import type { ApiFactory, RouterFactoryResult } from '../types.js';
+export declare const apiRouterFactory: <Context extends Record<string, unknown>>(context: Context, apiFactories: readonly ApiFactory<Context, ZodRawShape, ZodRawShape>[]) => 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,5 +1,5 @@
-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, }?: {

package/dist/http/mcp.js

@@ -1,9 +1,9 @@
-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;
@@ -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) => {
@@ -214,7 +215,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,15 @@
 #!/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 { ZodRawShape } from 'zod';
+import { type AdditionalSetupArgs } from './mcpServer.js';
+import type { ApiFactory, PromptFactory, 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 ApiFactory<Context, ZodRawShape, ZodRawShape>[];
+    promptFactories?: readonly PromptFactory<Context, ZodRawShape>[];
     resourceFactories?: readonly ResourceFactory<Context>[];
     additionalSetup?: (args: AdditionalSetupArgs<Context>) => void;
     cleanupFn?: () => void | Promise<void>;

package/dist/httpServer.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 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
@@ -31,7 +31,7 @@ export const httpServerFactory = ({ name, version, context, apiFactories = [], p
     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,

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,7 @@
 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 { ZodRawShape } from 'zod';
+import type { ApiFactory, McpFeatureFlags, PromptFactory, ResourceFactory } from './types.js';
 export interface AdditionalSetupArgs<Context extends Record<string, unknown>> {
     context: Context;
     server: McpServer;
@@ -10,8 +11,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 ApiFactory<Context, ZodRawShape, ZodRawShape>[];
+    promptFactories?: readonly PromptFactory<Context, ZodRawShape>[];
     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;
         }
     }
@@ -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,13 @@
 #!/usr/bin/env node
-import { ApiFactory, PromptFactory, ResourceFactory } from './types.js';
-import { AdditionalSetupArgs } from './mcpServer.js';
+import type { ZodRawShape } from 'zod';
+import { type AdditionalSetupArgs } from './mcpServer.js';
+import type { ApiFactory, PromptFactory, 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 ApiFactory<Context, ZodRawShape, ZodRawShape>[];
+    promptFactories?: readonly PromptFactory<Context, ZodRawShape>[];
     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,8 +1,7 @@
-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';
+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 ToolConfig<InputArgs extends ZodRawShape, OutputArgs extends ZodRawShape> = {
     title?: string;
     description?: string;

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.1",
   "description": "MCP boilerplate code for Node.js",
   "license": "Apache-2.0",
   "author": "TigerData",
@@ -31,17 +31,14 @@
   ],
   "scripts": {
     "build": "tsc",
-    "prepare": "npm run build",
+    "prepare": "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",
+    "@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 +50,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"