Add npm and PyPI wrapper packages, packages metadata, Glama badge

Author: sergey-ermakovich

.github/workflows/publish.yml

@@ -0,0 +1,65 @@
+# Publishes the npm and PyPI wrapper packages on a version tag, using OIDC
+# trusted publishing. No NPM_TOKEN or PYPI_TOKEN is stored anywhere: GitHub
+# mints a short-lived OIDC token per run, and npmjs.org / pypi.org accept it
+# because this repo + workflow are configured as trusted publishers.
+#
+# One-time setup, done once per package on the registries (not in this repo):
+#   npmjs.org  -> package settings -> Trusted Publisher -> GitHub Actions,
+#                 repo HasData/google-search-mcp, workflow publish.yml
+#   pypi.org   -> the hasdata org -> Publishing -> add a trusted publisher
+#                 (pending publisher works before the first release),
+#                 repo HasData/google-search-mcp, workflow publish.yml
+#
+# The MCP registry entry (com.hasdata/google-search) is NOT published here. It uses
+# domain auth, which would need the namespace-wide Ed25519 key as a secret in
+# every repo. That key stays off CI; the registry entry is published by hand
+# when server.json changes, after the package versions below are live.
+#
+# Release: bump nothing by hand. Tag the commit `vX.Y.Z` and push the tag; the
+# tag is the single source of the version and is written into both manifests.
+
+name: publish
+
+on:
+  push:
+    tags: ['v*.*.*']
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  npm:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+      - name: Set version from the tag
+        run: npm version "${GITHUB_REF_NAME#v}" --no-git-tag-version --allow-same-version
+      - name: Publish to npm (OIDC, no token)
+        run: npm publish --access public
+
+  pypi:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Set version from the tag
+        run: |
+          python - "${GITHUB_REF_NAME#v}" <<'PY'
+          import re, sys
+          v = sys.argv[1]
+          p = "pyproject.toml"
+          t = open(p, encoding="utf-8").read()
+          t = re.sub(r'(?m)^version = ".*"$', f'version = "{v}"', t, count=1)
+          open(p, "w", encoding="utf-8", newline="\n").write(t)
+          PY
+      - name: Build the wheel and sdist
+        run: pipx run build
+      - name: Publish to PyPI (OIDC, no token)
+        uses: pypa/gh-action-pypi-publish@release/v1

README.md

@@ -1,11 +1,14 @@
 # Google Search MCP Server (SERP)
 
+<!-- mcp-name: com.hasdata/google-search -->
+
 A hosted Model Context Protocol (MCP) server that gives Claude, Cursor, Windsurf and any other MCP client eight read-only Google Search tools. Pull the live SERP with its AI Overview and People Also Ask, run a Google AI Mode query, and read news, shopping, product detail and short-video results, all as structured JSON, with no Google Cloud project and no search-engine setup.
 
 ```
 https://mcp.hasdata.com/api/mcp?apis=google_serp
 ```
 
+[![Glama score](https://glama.ai/mcp/servers/HasData/google-search-mcp/badges/score.svg)](https://glama.ai/mcp/servers/HasData/google-search-mcp)
 [![tool contract](https://github.com/HasData/google-search-mcp/actions/workflows/contract.yml/badge.svg)](https://github.com/HasData/google-search-mcp/actions/workflows/contract.yml)
 [![MCP](https://img.shields.io/badge/MCP-remote%20%7C%20streamable%20HTTP-6366f1?style=flat-square)](https://modelcontextprotocol.io)
 [![Tools](https://img.shields.io/badge/tools-8-10b981?style=flat-square)](#tools)

hasdata_google_search_mcp/__init__.py

@@ -0,0 +1,28 @@
+"""Thin launcher for HasData's hosted Google Search (SERP) MCP server.
+
+Connects an MCP client to the remote streamable-HTTP endpoint through mcp-proxy.
+The server runs on HasData's infrastructure; this package only proxies stdio to it.
+"""
+import os
+import sys
+import subprocess
+
+URL = "https://mcp.hasdata.com/api/mcp?apis=google_serp"
+
+
+def main() -> None:
+    key = os.environ.get("HASDATA_API_KEY")
+    if not key:
+        sys.stderr.write(
+            "HASDATA_API_KEY is not set. Create a free key at https://app.hasdata.com "
+            "and set HASDATA_API_KEY.\n"
+        )
+        raise SystemExit(1)
+    args = [
+        sys.executable, "-m", "mcp_proxy", URL,
+        "--transport=streamablehttp",
+        "--headers", "x-api-key", key,
+    ]
+    rc = subprocess.call(args)
+    # subprocess returns -N when mcp_proxy is killed by signal N; map to 128+N.
+    raise SystemExit(rc if rc >= 0 else 128 - rc)

index.mjs

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+// Thin launcher: connects an MCP client to HasData's hosted Google Search MCP server
+// (streamable HTTP) through the mcp-remote stdio bridge. The server runs remotely;
+// this package only proxies, so nothing here scrapes anything.
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+
+const URL = 'https://mcp.hasdata.com/api/mcp?apis=google_serp';
+const key = process.env.HASDATA_API_KEY;
+if (!key) {
+  process.stderr.write('HASDATA_API_KEY is not set. Create a free key at https://app.hasdata.com and set HASDATA_API_KEY.\n');
+  process.exit(1);
+}
+// Resolve mcp-remote's CLI from its own package.json bin, so a future layout change
+// or an exports map does not break a hardcoded deep path.
+const require = createRequire(import.meta.url);
+const pkg = require('mcp-remote/package.json');
+const proxy = join(dirname(require.resolve('mcp-remote/package.json')), pkg.bin['mcp-remote']);
+const child = spawn(process.execPath, [proxy, URL, '--header', `x-api-key:${key}`], { stdio: 'inherit' });
+child.on('exit', (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  else process.exit(code ?? 0);
+});

package.json

@@ -1,11 +1,16 @@
 {
   "name": "@hasdata/google-search-mcp",
+  "mcpName": "com.hasdata/google-search",
   "version": "1.0.0",
-  "private": true,
-  "description": "Configuration and documentation for the HasData Google Search (SERP) MCP server",
+  "description": "MCP server for Google Search (SERP) through HasData's hosted API: organic results, AI Overview, People Also Ask, AI Mode, news, shopping, product and short videos. No Google Cloud project.",
+  "type": "module",
+  "bin": { "hasdata-google-search-mcp": "index.mjs" },
+  "files": ["index.mjs", "README.md", "LICENSE"],
+  "scripts": { "test": "node --test" },
+  "dependencies": { "mcp-remote": "^0.1.43" },
+  "engines": { "node": ">=18" },
   "license": "MIT",
   "repository": { "type": "git", "url": "https://github.com/HasData/google-search-mcp.git" },
   "homepage": "https://hasdata.com/apis/google-serp-api",
-  "scripts": { "test": "node --test" },
-  "engines": { "node": ">=22" }
+  "keywords": ["mcp", "google-search", "google-serp", "serp", "google-search-mcp", "serp-mcp", "model-context-protocol", "hasdata", "scraper", "ai-overview"]
 }

pyproject.toml

@@ -0,0 +1,24 @@
+[project]
+name = "hasdata-google-search-mcp"
+version = "1.0.0"
+description = "MCP server for Google Search (SERP) through HasData's hosted API. No Google Cloud project, no search-engine setup."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+keywords = ["mcp", "google-search", "google-serp", "serp", "model-context-protocol", "hasdata"]
+# mcp is pinned below 2 because mcp-proxy 0.12.0 imports request_ctx, removed in the mcp 2.x SDK.
+dependencies = ["mcp-proxy>=0.12.0", "mcp>=1.17,<2"]
+
+[project.urls]
+Homepage = "https://hasdata.com/apis/google-serp-api"
+Repository = "https://github.com/HasData/google-search-mcp"
+
+[project.scripts]
+hasdata-google-search-mcp = "hasdata_google_search_mcp:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["hasdata_google_search_mcp"]

server.json

@@ -3,7 +3,7 @@
   "name": "com.hasdata/google-search",
   "title": "HasData Google Search (SERP)",
   "description": "Google SERP as JSON: organic, AI Overview, People Also Ask, AI Mode, news, shopping. No Cloud setup.",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "websiteUrl": "https://hasdata.com/apis/google-serp-api",
   "repository": { "url": "https://github.com/HasData/google-search-mcp", "source": "github" },
   "remotes": [
@@ -14,5 +14,26 @@
         { "name": "x-api-key", "description": "HasData API key, created at app.hasdata.com. The free trial needs no card.", "isRequired": true, "isSecret": true }
       ]
     }
+  ],
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@hasdata/google-search-mcp",
+      "version": "1.0.0",
+      "transport": { "type": "stdio" },
+      "environmentVariables": [
+        { "name": "HASDATA_API_KEY", "description": "HasData API key, created at app.hasdata.com. The free trial needs no card.", "isRequired": true, "isSecret": true }
+      ]
+    },
+    {
+      "registryType": "pypi",
+      "identifier": "hasdata-google-search-mcp",
+      "version": "1.0.0",
+      "runtimeHint": "uvx",
+      "transport": { "type": "stdio" },
+      "environmentVariables": [
+        { "name": "HASDATA_API_KEY", "description": "HasData API key, created at app.hasdata.com. The free trial needs no card.", "isRequired": true, "isSecret": true }
+      ]
+    }
   ]
 }