ebay-mcp 1.9.0 → 1.10.0

package/build/index.js

@@ -5,8 +5,7 @@ import { createEbayMcpRuntime } from './mcp/runtime.js';
 import { runSetup } from './scripts/setup.js';
 import { getErrorMessage } from './utils/errors.js';
 import { serverLogger, getLogPaths } from './utils/logger.js';
-import { checkForUpdates } from './utils/version.js';
-checkForUpdates({ defer: true });
+import { getCachedUpdateNotice } from './utils/version.js';
 const args = process.argv.slice(2);
 if (args.includes('setup')) {
     try {
@@ -43,6 +42,12 @@ class EbayMcpServer {
     }
     async run() {
         serverLogger.info('Starting eBay API MCP Server');
+        // stdout is reserved for the MCP protocol, so a TTY update box (used by the
+        // CLIs) can't run here — surface any newer version as a stderr log line.
+        const updateNotice = getCachedUpdateNotice();
+        if (updateNotice) {
+            serverLogger.info(updateNotice);
+        }
         // Validate environment configuration
         const validation = validateEnvironmentConfig();
         // Log informational notices (e.g. proxy auth mode)

package/build/scripts/diagnostics.js

@@ -17,6 +17,7 @@ import { displayScopeVerification, parseScopeString } from '../utils/scope-helpe
 import { readEnvironment } from './setup-shared.js';
 import { EbaySellerApi } from '../api/index.js';
 import { getErrorMessage } from '../utils/errors.js';
+import { getUpdateInfo, getVersion } from '../utils/version.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const PROJECT_ROOT = join(__dirname, '../..');
@@ -83,6 +84,30 @@ function displaySystemInfo() {
     console.log(`  ${chalk.gray('CWD:')} ${process.cwd()}`);
     console.log('');
 }
+/**
+ * Check npm for a newer published version and surface it. `diagnose` is an
+ * intentional, interactive command run by the user, so a live registry fetch is
+ * appropriate here (unlike the server hot path, which uses the cached check).
+ * A failed fetch (offline) is reported, not thrown — diagnostics should never
+ * abort on a best-effort network call.
+ */
+async function displayUpdateStatus() {
+    console.log(chalk.bold.cyan('🔄 Version\n'));
+    console.log(`  ${chalk.gray('Installed:')} ${getVersion()}`);
+    try {
+        const info = await getUpdateInfo();
+        if (info) {
+            console.log(`  ${chalk.gray('Latest:')}    ${chalk.green(info.latest)} ${chalk.yellow(`(run \`npm i -g ${info.name}\` to update)`)}`);
+        }
+        else {
+            console.log(`  ${chalk.gray('Latest:')}    ${chalk.green('up to date')}`);
+        }
+    }
+    catch {
+        console.log(`  ${chalk.gray('Latest:')}    ${chalk.dim('update check unavailable (offline?)')}`);
+    }
+    console.log('');
+}
 /**
  * Display configuration status
  */
@@ -210,6 +235,7 @@ async function generateDiagnosticReport(exportPath) {
 async function runDiagnostics(exportReport = false) {
     displayHeader();
     displaySystemInfo();
+    await displayUpdateStatus();
     // Security checks
     const securityResults = await runSecurityChecks(PROJECT_ROOT);
     displaySecurityResults(securityResults);

package/build/utils/version.js

@@ -48,20 +48,53 @@ export function getPackageName() {
 }
 const ONE_DAY_MS = 1000 * 60 * 60 * 24;
 /**
- * Notifies global CLI users when a newer package version is available.
+ * Surface a "newer version available" box in an interactive terminal — the
+ * setup wizard and `diagnose`.
+ *
+ * `shouldNotifyInNpmScript: true` is essential: these CLIs are launched via
+ * `npm run setup` / `npx`, and without this flag update-notifier suppresses the
+ * notice whenever it detects an npm/yarn user agent (the common case). The
+ * notice is still a no-op when stdout is not a TTY (e.g. the MCP server's piped
+ * stdio); that path uses {@link getCachedUpdateNotice} instead. Dropping the
+ * old custom `message` lets update-notifier render its default colorized
+ * template (dim current → green latest, cyan command).
  */
 export function checkForUpdates(options = {}) {
     const pkg = getPackageJson();
     const notifier = updateNotifier({
         pkg,
         updateCheckInterval: ONE_DAY_MS,
+        shouldNotifyInNpmScript: true,
     });
     notifier.notify({
         isGlobal: true,
         defer: options.defer ?? false,
-        message: 'Update available {currentVersion} → {latestVersion}\n' + 'Run {updateCommand} to update',
     });
 }
+/**
+ * Build a one-line "update available" notice from update-notifier's cached
+ * daily check, for contexts with no TTY where {@link checkForUpdates} stays
+ * silent — chiefly the MCP server, whose stdout is reserved for the protocol so
+ * the notice must go to a stderr log line instead of a box.
+ *
+ * Constructing the notifier triggers the once-a-day background check and reads
+ * its cached result, so this never blocks startup or hits the network on the
+ * hot path. Returns `undefined` when already current, or before the first
+ * background check has populated the cache (so the notice appears from the
+ * second run onward — update-notifier's normal behavior).
+ */
+export function getCachedUpdateNotice() {
+    const pkg = getPackageJson();
+    const notifier = updateNotifier({
+        pkg,
+        updateCheckInterval: ONE_DAY_MS,
+    });
+    const { update } = notifier;
+    if (!update || update.latest === pkg.version) {
+        return undefined;
+    }
+    return `Update available ${pkg.version} → ${update.latest} — run \`npm i -g ${pkg.name}\` to update`;
+}
 /**
  * Fetches update metadata without printing a notification.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ebay-mcp",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Model Context Protocol (MCP) server that exposes 100% of eBay's Sell APIs (332 tools across 270 endpoints) to AI assistants like Claude, Cursor, and Cline, covering inventory, order fulfillment, marketing, analytics, and developer tools with OAuth authentication and refresh-token support.",
   "type": "module",
   "main": "build/index.js",