@findtime/mcp-server 3.25.6 → 3.25.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@findtime/mcp-server",
-  "version": "3.25.6",
+  "version": "3.25.8",
   "mcpName": "io.github.hkchao/findtime-mcp-server",
   "description": "Production-parity MCP server for the findtime.io Time API",
   "bin": {

package/server.js

@@ -19,6 +19,10 @@ loadEnvironmentFiles();
 
 const PACKAGE_METADATA = safeReadJson(LOCAL_PACKAGE_PATH) || safeReadJson(REPO_PACKAGE_PATH) || {};
 const SERVER_VERSION = PACKAGE_METADATA.version || '0.0.0';
+const MCP_PACKAGE_NAME = PACKAGE_METADATA.name || '@findtime/mcp-server';
+const MCP_NPM_REGISTRY_LATEST_URL = `https://registry.npmjs.org/${encodeURIComponent(MCP_PACKAGE_NAME)}/latest`;
+const MCP_NPM_URL = `https://www.npmjs.com/package/${MCP_PACKAGE_NAME}`;
+const MCP_REGISTRY_URL = 'https://registry.modelcontextprotocol.io/?q=io.github.hkchao%2Ffindtime-mcp-server';
 const DEFAULT_API_BASE_URL = firstNonEmpty(
   process.env.TIME_API_BASE_URL,
   process.env.FINDTIME_TIME_API_BASE_URL
@@ -33,6 +37,18 @@ const DEFAULT_API_KEY = firstNonEmpty(
 const TIMEZONE_HELPERS_PATH = path.join(REPO_ROOT, 'slack-bot', 'timezone-helpers.js');
 
 const TOOL_DEFINITIONS = [
+  {
+    name: 'get_api_diagnostics',
+    description: 'Return MCP and findtime Time API diagnostics, including the running MCP version, latest published MCP version, API base URL, auth configuration, and a live health check.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      additionalProperties: false
+    },
+    buildRequest() {
+      return { path: '/health', params: new URLSearchParams() };
+    }
+  },
   {
     name: 'time_snapshot',
     description: 'Return the production time snapshot payload for one location or a list of locations.',
@@ -806,12 +822,120 @@ function createFindtimeMcpServer(options = {}) {
     }
   }
 
+  async function fetchLatestMcpVersion() {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+
+    try {
+      const response = await fetchImpl(MCP_NPM_REGISTRY_LATEST_URL, {
+        method: 'GET',
+        headers: {
+          Accept: 'application/json'
+        },
+        signal: controller.signal
+      });
+
+      const rawBody = await response.text();
+      const parsedBody = tryParseJson(rawBody);
+
+      if (!response.ok) {
+        return {
+          ok: false,
+          status: response.status,
+          latestVersion: null
+        };
+      }
+
+      const latestVersion = parsedBody && typeof parsedBody.version === 'string'
+        ? parsedBody.version.trim()
+        : '';
+
+      if (!latestVersion) {
+        return {
+          ok: false,
+          status: response.status,
+          latestVersion: null
+        };
+      }
+
+      return {
+        ok: true,
+        status: response.status,
+        latestVersion
+      };
+    } catch (error) {
+      return {
+        ok: false,
+        status: null,
+        latestVersion: null,
+        networkError: error && error.name === 'AbortError'
+          ? `Request timed out after ${timeoutMs}ms`
+          : String(error && error.message ? error.message : error)
+      };
+    } finally {
+      clearTimeout(timeout);
+    }
+  }
+
   async function callTool(name, args = {}) {
     const tool = TOOL_DEFINITIONS_BY_NAME.get(name);
     if (!tool) {
       throw invalidParamsError(`Unknown tool: ${name}`);
     }
 
+    if (name === 'get_api_diagnostics') {
+      const request = tool.buildRequest(args || {});
+      const [apiResponse, latestMcpVersionCheck] = await Promise.all([
+        fetchJson(name, request),
+        fetchLatestMcpVersion()
+      ]);
+      const checkedAt = new Date().toISOString();
+      const latestVersion = latestMcpVersionCheck.latestVersion || null;
+      const diagnostics = {
+        ok: apiResponse.ok,
+        tool: name,
+        checkedAt,
+        mcpVersion: SERVER_VERSION,
+        mcpLatestVersion: latestVersion,
+        mcpUpToDate: latestVersion ? latestVersion === SERVER_VERSION : null,
+        mcpLatestVersionCheck: latestVersion ? 'ok' : 'failed',
+        mcpLatestVersionSource: latestVersion ? 'npm' : 'unavailable',
+        mcpLatestVersionHint: latestVersion
+          ? null
+          : 'Could not verify the latest published MCP version automatically. Check the npm package page or Official MCP Registry listing directly.',
+        mcpRegistryUrl: MCP_REGISTRY_URL,
+        mcpNpmUrl: MCP_NPM_URL,
+        apiBaseUrl,
+        apiConfigured: Boolean(apiBaseUrl),
+        apiAuthConfigured: Boolean(typeof apiKey === 'string' && apiKey.trim()),
+        clientType: firstNonEmpty(
+          process.env.FINDTIME_MCP_CLIENT_TYPE,
+          process.env.TIME_API_CLIENT_TYPE
+        ) || null,
+        apiHealthUrl: apiResponse.url,
+        apiStatus: apiResponse.status,
+        apiReachable: apiResponse.ok
+      };
+
+      if (apiResponse.ok) {
+        diagnostics.apiHealth = apiResponse.parsedBody;
+      } else {
+        diagnostics.error = apiResponse.parsedBody !== undefined ? apiResponse.parsedBody : apiResponse.rawBody;
+        if (apiResponse.networkError) {
+          diagnostics.networkError = apiResponse.networkError;
+        }
+      }
+
+      if (!latestVersion && latestMcpVersionCheck.networkError) {
+        diagnostics.mcpLatestVersionNetworkError = latestMcpVersionCheck.networkError;
+      }
+
+      return buildToolSuccessResult(name, diagnostics, {
+        endpoint: request.path,
+        url: apiResponse.url
+      });
+    }
+
     const request = tool.buildRequest(args || {});
     let apiResponse = await fetchJson(name, request);