@digestseo/mcp-gsc 0.4.18 → 0.4.19

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.19] - 2026-09-22
+
+### Fixed
+- Search Analytics freshness metadata now normalizes Google's camelCase `firstIncompleteDate` / `firstIncompleteHour` wire fields into the stable MCP `first_incomplete_date` / `first_incomplete_hour` response contract.
+- The npm launcher now exits deterministically after its Wrangler child terminates by signal instead of re-signalling itself while its own `SIGINT`/`SIGTERM` listeners are installed, preventing wrapper processes from lingering after Ctrl+C or supervisor shutdown on POSIX systems.
+- ChatGPT local-launcher guidance now explicitly requires Secure MCP Tunnel for the loopback `127.0.0.1` endpoint, or a separately deployed remote Worker, instead of implying that ChatGPT can connect directly to localhost.
+
 ## [0.4.18] - 2026-09-22
 
 ### Fixed

package/README.md

@@ -62,7 +62,7 @@ claude mcp add --transport http gsc http://127.0.0.1:8080/mcp
 
 Start the npm launcher before using either install button. Complete its Google OAuth flow on first use.
 
-**ChatGPT** — add it as a custom MCP app in developer mode; see [Connect in your AI client](#connect-in-your-ai-client) below.
+**ChatGPT** — ChatGPT cannot connect directly to this loopback `127.0.0.1` endpoint. Use OpenAI's **Secure MCP Tunnel** for the local launcher, or deploy your own remote Cloudflare Worker and add that `/mcp` URL as a custom MCP app in Developer mode; see [Connect in your AI client](#connect-in-your-ai-client) below.
 
 A self-hostable [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **Google Search Console**. Connect it to Claude.ai, Cursor, ChatGPT, or any MCP-compatible client and ask your AI assistant about your site's organic search performance — impressions, clicks, top queries, index status, and sitemap health — straight from your own Google account.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digestseo/mcp-gsc",
-  "version": "0.4.18",
+  "version": "0.4.19",
   "private": false,
   "main": "scripts/glama-start.mjs",
   "bin": {

package/scripts/glama-start.mjs

@@ -1,6 +1,6 @@
 import { spawn } from 'node:child_process';
 import { createRequire } from 'node:module';
-import { homedir } from 'node:os';
+import { constants, homedir } from 'node:os';
 import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -51,7 +51,8 @@ process.on('SIGTERM', () => forwardSignal('SIGTERM'));
 
 child.on('exit', (code, signal) => {
   if (signal) {
-    process.kill(process.pid, signal);
+    const signalNumber = constants.signals[signal];
+    process.exit(signalNumber === undefined ? 1 : 128 + signalNumber);
   } else {
     process.exit(code ?? 1);
   }

package/src/google.ts

@@ -407,6 +407,11 @@ export interface SearchAnalyticsResponseMetadata {
   first_incomplete_hour?: string;
 }
 
+interface GoogleSearchAnalyticsResponseMetadata {
+  firstIncompleteDate?: string;
+  firstIncompleteHour?: string;
+}
+
 export interface SearchAnalyticsResponse {
   rows: SearchAnalyticsRow[];
   responseAggregationType?: string;
@@ -610,14 +615,25 @@ export async function querySearchAnalytics(
   const data = (await resp.json()) as {
     rows?: SearchAnalyticsRow[];
     responseAggregationType?: string;
-    metadata?: SearchAnalyticsResponseMetadata;
+    metadata?: GoogleSearchAnalyticsResponseMetadata;
   };
+  const metadata: SearchAnalyticsResponseMetadata | undefined =
+    data.metadata === undefined
+      ? undefined
+      : {
+          ...(data.metadata.firstIncompleteDate !== undefined
+            ? { first_incomplete_date: data.metadata.firstIncompleteDate }
+            : {}),
+          ...(data.metadata.firstIncompleteHour !== undefined
+            ? { first_incomplete_hour: data.metadata.firstIncompleteHour }
+            : {}),
+        };
   return {
     rows: data.rows ?? [],
     ...(data.responseAggregationType !== undefined
       ? { responseAggregationType: data.responseAggregationType }
       : {}),
-    ...(data.metadata !== undefined ? { metadata: data.metadata } : {}),
+    ...(metadata !== undefined ? { metadata } : {}),
   };
 }