@nekzus/mcp-server 1.18.3 → 1.19.0-alpha.10

package/dist/src/schemas.js

@@ -0,0 +1,189 @@
+import { z } from 'zod';
+export const NpmMaintainerSchema = z
+    .object({
+    name: z.string(),
+    email: z.string().optional(),
+    url: z.string().optional(),
+})
+    .loose();
+export const NpmPackageVersionSchema = z
+    .object({
+    name: z.string(),
+    version: z.string(),
+    description: z.string().optional(),
+    author: z
+        .union([
+        z.string(),
+        z
+            .object({
+            name: z.string().optional(),
+            email: z.string().optional(),
+            url: z.string().optional(),
+        })
+            .loose(),
+    ])
+        .optional(),
+    license: z.string().optional(),
+    repository: z
+        .object({
+        type: z.string().optional(),
+        url: z.string().optional(),
+    })
+        .loose()
+        .optional(),
+    bugs: z
+        .object({
+        url: z.string().optional(),
+    })
+        .loose()
+        .optional(),
+    homepage: z.string().optional(),
+    dependencies: z.record(z.string(), z.string()).optional(),
+    devDependencies: z.record(z.string(), z.string()).optional(),
+    peerDependencies: z.record(z.string(), z.string()).optional(),
+    types: z.string().optional(),
+    typings: z.string().optional(),
+    dist: z
+        .object({ shasum: z.string().optional(), tarball: z.string().optional() })
+        .loose()
+        .optional(),
+})
+    .loose();
+export const NpmPackageInfoSchema = z
+    .object({
+    name: z.string(),
+    'dist-tags': z.record(z.string(), z.string()),
+    versions: z.record(z.string(), NpmPackageVersionSchema),
+    time: z.record(z.string(), z.string()).optional(),
+    repository: z
+        .object({
+        type: z.string().optional(),
+        url: z.string().optional(),
+    })
+        .loose()
+        .optional(),
+    bugs: z
+        .object({
+        url: z.string().optional(),
+    })
+        .loose()
+        .optional(),
+    homepage: z.string().optional(),
+    maintainers: z.array(NpmMaintainerSchema).optional(),
+})
+    .loose();
+export const NpmPackageDataSchema = z
+    .object({
+    name: z.string(),
+    version: z.string(),
+    description: z.string().optional(),
+    license: z.string().optional(),
+    dependencies: z.record(z.string(), z.string()).optional(),
+    devDependencies: z.record(z.string(), z.string()).optional(),
+    peerDependencies: z.record(z.string(), z.string()).optional(),
+    types: z.string().optional(),
+    typings: z.string().optional(),
+})
+    .loose();
+export const BundlephobiaDataSchema = z.object({
+    size: z.number(),
+    gzip: z.number(),
+    dependencyCount: z.number(),
+});
+export const NpmDownloadsDataSchema = z.object({
+    downloads: z.number(),
+    start: z.string(),
+    end: z.string(),
+    package: z.string(),
+});
+export const NpmSearchResultSchema = z
+    .object({
+    objects: z.array(z.object({
+        package: z.object({
+            name: z.string(),
+            version: z.string(),
+            description: z.string().optional(),
+            keywords: z.array(z.string()).optional(),
+            publisher: z
+                .object({
+                username: z.string(),
+                email: z.string().optional(),
+            })
+                .optional(),
+            links: z
+                .object({
+                npm: z.string().optional(),
+                homepage: z.string().optional(),
+                repository: z.string().optional(),
+                bugs: z.string().optional(),
+            })
+                .optional(),
+            date: z.string().optional(),
+        }),
+        score: z.object({
+            final: z.number(),
+            detail: z.object({
+                quality: z.number(),
+                popularity: z.number(),
+                maintenance: z.number(),
+            }),
+        }),
+        searchScore: z.number(),
+    })),
+    total: z.number(),
+})
+    .loose();
+export function isNpmPackageInfo(data) {
+    return (typeof data === 'object' &&
+        data !== null &&
+        (!('maintainers' in data) ||
+            (Array.isArray(data.maintainers) &&
+                (data.maintainers?.every((m) => typeof m === 'object' &&
+                    m !== null &&
+                    'name' in m &&
+                    'email' in m &&
+                    typeof m.name === 'string' &&
+                    typeof m.email === 'string') ??
+                    true))));
+}
+export function isNpmPackageData(data) {
+    try {
+        const result = NpmPackageDataSchema.safeParse(data);
+        if (!result.success) {
+            console.error('isNpmPackageData validation failed:', JSON.stringify(result.error.issues, null, 2));
+        }
+        return result.success;
+    }
+    catch (e) {
+        console.error('isNpmPackageData threw exception:', e);
+        return false;
+    }
+}
+export function isBundlephobiaData(data) {
+    try {
+        return BundlephobiaDataSchema.parse(data) !== null;
+    }
+    catch {
+        return false;
+    }
+}
+export function isNpmDownloadsData(data) {
+    try {
+        const result = NpmDownloadsDataSchema.safeParse(data);
+        if (!result.success) {
+            console.error('isNpmDownloadsData validation failed:', JSON.stringify(result.error.issues, null, 2));
+        }
+        return result.success;
+    }
+    catch {
+        return false;
+    }
+}
+export function isValidNpmPackageName(name) {
+    const npmPackageRegex = /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+    return (npmPackageRegex.test(name) &&
+        name.length <= 214 &&
+        !name.startsWith('_') &&
+        !name.startsWith('.'));
+}
+//# sourceMappingURL=schemas.js.map

package/dist/src/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/src/server.d.ts

@@ -0,0 +1,7 @@
+import type { z } from 'zod';
+import { type configSchema } from './config.js';
+export { configSchema } from './config.js';
+export default function createServer({ config }: {
+    config: z.infer<typeof configSchema>;
+}): import("@modelcontextprotocol/server").Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,KAAK,YAAY,EAA+C,MAAM,aAAa,CAAC;AAK7F,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;CAAE,iDAiBxF"}

package/dist/src/server.js

@@ -0,0 +1,21 @@
+import { McpServer } from '@modelcontextprotocol/server';
+import { getPackageRootAndVersion, setNpmRegistryUrl } from './config.js';
+import { registerAllPrompts } from './prompts/index.js';
+import { registerAllResources } from './resources/index.js';
+import { registerAllTools } from './tools/index.js';
+export { configSchema } from './config.js';
+export default function createServer({ config }) {
+    if (config.NPM_REGISTRY_URL) {
+        setNpmRegistryUrl(config.NPM_REGISTRY_URL);
+    }
+    const { packageRoot, serverVersion } = getPackageRootAndVersion();
+    const server = new McpServer({
+        name: 'npm-sentinel-mcp',
+        version: serverVersion,
+    });
+    registerAllResources(server, packageRoot);
+    registerAllPrompts(server);
+    registerAllTools(server);
+    return server.server;
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAqB,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAE,MAAM,EAA4C;IACxF,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC7B,iBAAiB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,wBAAwB,EAAE,CAAC;IAElE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC5B,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,aAAa;KACtB,CAAC,CAAC;IAEH,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEzB,OAAO,MAAM,CAAC,MAAM,CAAC;AACtB,CAAC"}

package/dist/src/tools/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+export declare function registerAllTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,SAAS,EAAE,MAAM,8BAA8B,CAAC;AA8E9E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqdxD"}

package/dist/src/tools/index.js

@@ -0,0 +1,411 @@
+import { z } from 'zod';
+import { handleNpmAlternatives, handleNpmChangelogAnalysis, handleNpmCompare, handleNpmDeprecated, handleNpmDeps, handleNpmLatest, handleNpmLicenseCompatibility, handleNpmMaintainers, handleNpmMaintenance, handleNpmPackageReadme, handleNpmQuality, handleNpmRepoStats, handleNpmScore, handleNpmSearch, handleNpmSize, handleNpmTrends, handleNpmTypes, handleNpmVersions, handleNpmVulnerabilities, } from '../handlers/index.js';
+import { NPM_METRICS_ICON, NPM_REGISTRY_ICON, NPM_SECURITY_ICON } from '../icons.js';
+// Helper schemas for structured outputs (MCP v2)
+const BatchResultOutputSchema = z
+    .object({
+    results: z.array(z.record(z.string(), z.unknown())).optional(),
+    summary: z.record(z.string(), z.unknown()).optional(),
+    message: z.string().optional(),
+})
+    .passthrough();
+const SearchResultOutputSchema = z
+    .object({
+    query: z.string().optional(),
+    limitUsed: z.number().optional(),
+    totalResults: z.number().optional(),
+    resultsCount: z.number().optional(),
+    results: z.array(z.record(z.string(), z.unknown())).optional(),
+    message: z.string().optional(),
+})
+    .passthrough();
+const CompareResultOutputSchema = z
+    .object({
+    queryPackages: z.array(z.string()).optional(),
+    results: z.array(z.record(z.string(), z.unknown())).optional(),
+    message: z.string().optional(),
+})
+    .passthrough();
+const LicenseCompatibilityResultOutputSchema = z
+    .object({
+    packagesAnalyzed: z.array(z.string()).optional(),
+    compatibility: z.record(z.string(), z.unknown()).optional(),
+    licenseDetails: z.array(z.record(z.string(), z.unknown())).optional(),
+})
+    .passthrough();
+async function withStructuredOutput(handlerPromise) {
+    const res = await handlerPromise;
+    try {
+        const text = res.content[0]?.text;
+        if (text && (text.startsWith('{') || text.startsWith('['))) {
+            const parsed = JSON.parse(text);
+            return {
+                ...res,
+                structuredContent: parsed,
+            };
+        }
+    }
+    catch { }
+    return res;
+}
+export function registerAllTools(server) {
+    server.registerTool('npmVersions', {
+        description: 'Get all available versions of an NPM package',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to get versions for'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_REGISTRY_ICON,
+        annotations: {
+            title: 'Get All Package Versions',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmVersions for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmVersions(args));
+    });
+    server.registerTool('npmLatest', {
+        description: 'Get the latest version and changelog of an NPM package',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to get latest versions for'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_REGISTRY_ICON,
+        annotations: {
+            title: 'Get Latest Package Information',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmLatest for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmLatest(args));
+    });
+    server.registerTool('npmDeps', {
+        description: 'Analyze dependencies and devDependencies of an NPM package',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to analyze dependencies for'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_REGISTRY_ICON,
+        annotations: {
+            title: 'Get Package Dependencies',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmDeps for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmDeps(args));
+    });
+    server.registerTool('npmTypes', {
+        description: 'Check TypeScript types availability and version for a package',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to check types for'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_REGISTRY_ICON,
+        annotations: {
+            title: 'Check TypeScript Type Availability',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmTypes for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmTypes(args));
+    });
+    server.registerTool('npmSize', {
+        description: 'Get package size information including dependencies and bundle size',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to get size information for'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_METRICS_ICON,
+        annotations: {
+            title: 'Get Package Size (Bundlephobia)',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmSize for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmSize(args));
+    });
+    server.registerTool('npmVulnerabilities', {
+        description: 'Check for known vulnerabilities in packages',
+        inputSchema: z.object({
+            packages: z
+                .array(z.string())
+                .describe('List of package names to check for vulnerabilities'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_SECURITY_ICON,
+        annotations: {
+            title: 'Check Package Vulnerabilities (OSV.dev)',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: false,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmVulnerabilities for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmVulnerabilities(args));
+    });
+    server.registerTool('npmTrends', {
+        description: 'Get download trends and popularity metrics for packages',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to get trends for'),
+            period: z
+                .enum(['last-week', 'last-month', 'last-year'])
+                .describe('Time period for trends. Options: "last-week", "last-month", "last-year"')
+                .optional()
+                .default('last-month'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_METRICS_ICON,
+        annotations: {
+            title: 'Get NPM Package Download Trends',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmTrends for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmTrends(args));
+    });
+    server.registerTool('npmCompare', {
+        description: 'Compare multiple NPM packages based on various metrics',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to compare'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: CompareResultOutputSchema,
+        icons: NPM_METRICS_ICON,
+        annotations: {
+            title: 'Compare NPM Packages',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmCompare for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmCompare(args));
+    });
+    server.registerTool('npmMaintainers', {
+        description: 'Get maintainers information for NPM packages',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to get maintainers for'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_METRICS_ICON,
+        annotations: {
+            title: 'Get NPM Package Maintainers',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmMaintainers for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmMaintainers(args));
+    });
+    server.registerTool('npmScore', {
+        description: 'Get consolidated package score based on quality, maintenance, and popularity metrics',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to get scores for'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_METRICS_ICON,
+        annotations: {
+            title: 'Get NPM Package Score (NPMS.io)',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmScore for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmScore(args));
+    });
+    server.registerTool('npmPackageReadme', {
+        description: 'Get the README content for NPM packages',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to get READMEs for'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_REGISTRY_ICON,
+        annotations: {
+            title: 'Get NPM Package README',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmPackageReadme for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmPackageReadme(args));
+    });
+    server.registerTool('npmSearch', {
+        description: 'Search for NPM packages with optional limit',
+        inputSchema: z.object({
+            query: z.string().describe('Search query for packages'),
+            limit: z
+                .number()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe('Maximum number of results to return (default: 10)'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: SearchResultOutputSchema,
+        icons: NPM_REGISTRY_ICON,
+        annotations: {
+            title: 'Search NPM Packages',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: false,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmSearch for query: "${args.query}"`);
+        return await withStructuredOutput(handleNpmSearch(args));
+    });
+    server.registerTool('npmLicenseCompatibility', {
+        description: 'Check license compatibility between multiple packages',
+        inputSchema: z.object({
+            packages: z
+                .array(z.string())
+                .min(1)
+                .describe('List of package names to check for license compatibility'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: LicenseCompatibilityResultOutputSchema,
+        icons: NPM_REGISTRY_ICON,
+        annotations: {
+            title: 'Check NPM License Compatibility',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmLicenseCompatibility for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmLicenseCompatibility(args));
+    });
+    server.registerTool('npmRepoStats', {
+        description: 'Get repository statistics for NPM packages',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to get repository stats for'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_SECURITY_ICON,
+        annotations: {
+            title: 'Get NPM Package Repository Stats (GitHub)',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmRepoStats for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmRepoStats(args));
+    });
+    server.registerTool('npmDeprecated', {
+        description: 'Check if packages are deprecated',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to check for deprecation'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_SECURITY_ICON,
+        annotations: {
+            title: 'Check NPM Package Deprecation Status',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmDeprecated for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmDeprecated(args));
+    });
+    server.registerTool('npmChangelogAnalysis', {
+        description: 'Analyze changelog and release history of packages',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to analyze changelogs for'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_SECURITY_ICON,
+        annotations: {
+            title: 'Analyze NPM Package Changelog (GitHub)',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmChangelogAnalysis for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmChangelogAnalysis(args));
+    });
+    server.registerTool('npmAlternatives', {
+        description: 'Find alternative packages with similar functionality',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to find alternatives for'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_SECURITY_ICON,
+        annotations: {
+            title: 'Find NPM Package Alternatives',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: false,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmAlternatives for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmAlternatives(args));
+    });
+    server.registerTool('npmQuality', {
+        description: 'Analyze package quality metrics',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to analyze'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_METRICS_ICON,
+        annotations: {
+            title: 'Analyze NPM Package Quality (NPMS.io)',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmQuality for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmQuality(args));
+    });
+    server.registerTool('npmMaintenance', {
+        description: 'Analyze package maintenance metrics',
+        inputSchema: z.object({
+            packages: z.array(z.string()).describe('List of package names to analyze'),
+            ignoreCache: z.boolean().optional().describe('Force a fresh lookup, ignoring the cache'),
+        }),
+        outputSchema: BatchResultOutputSchema,
+        icons: NPM_METRICS_ICON,
+        annotations: {
+            title: 'Analyze NPM Package Maintenance (NPMS.io)',
+            readOnlyHint: true,
+            openWorldHint: true,
+            idempotentHint: true,
+        },
+    }, async (args, ctx) => {
+        await ctx?.mcpReq?.log?.('info', `Executing npmMaintenance for ${args.packages.join(', ')}`);
+        return await withStructuredOutput(handleNpmMaintenance(args));
+    });
+}
+//# sourceMappingURL=index.js.map