@vernikr/gemini-mcp 0.0.0-stage → 0.8.1

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# @vernikr/gemini-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+One-command Gemini **free-tier** MCP gateway (Python core: `gemini-mcp-gateway` on PyPI,
+bootstrapped via [uv](https://docs.astral.sh/uv/) — no system Python needed). Works
+**without any server**: default `direct` mode talks to Google AI Studio straight from
+your machine; `router` mode joins a fleet gateway with a shared quota ledger.
+
+```bash
+pnpm dlx @vernikr/gemini-mcp setup     # wizard: AI Studio keys → ~/.config/gemini-mcp
+                                       #         → live key probe → client snippets
+pnpm dlx @vernikr/gemini-mcp doctor    # self-check with fix commands
+pnpm dlx @vernikr/gemini-mcp quota     # free-tier budget table
+pnpm dlx @vernikr/gemini-mcp uninstall --yes   # remove keys+config
+```
+
+Features: quota-aware routing across the Flash chain (two routes: `optimal` /
+`best_available`), massive-body chunked analysis with consolidation, file ingest with
+server-side RTF/DOCX→Markdown extraction, async tickets for long jobs, structured
+agent-facing errors. Repo: github.com/vernikr/gemini-mcp

package/bin/gemini-mcp.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+"use strict";
+/* @vernikr/gemini-mcp — thin bootstrap: runs the pinned Python core
+   (PyPI dist: gemini-mcp-gateway) through uv. No core logic lives here.
+   Version lockstep: this package's version == the PyPI pin. */
+const { spawnSync } = require("node:child_process");
+const CORE = "gemini-mcp-gateway";
+const VER = require("../package.json").version;
+
+function uvx() {
+  const hit = spawnSync("sh", ["-c", "command -v uvx"], { encoding: "utf8" });
+  if (hit.status === 0 && hit.stdout.trim()) return [hit.stdout.trim(), []];
+  return ["npx", ["-y", "@astral-sh/uv", "uvx"]];   // uv self-installs via npm
+}
+const [cmd, base] = uvx();
+// bin name != dist name: uvx needs --from (verified against PyPI 0.7.1)
+const res = spawnSync(cmd, [...base, "--from", `${CORE}==${VER}`, "gemini-mcp",
+  ...process.argv.slice(2)],
+  { stdio: "inherit" });
+if (res.error) {
+  console.error(`gemini-mcp: bootstrap failed: ${res.error.message}`);
+  console.error("hint: install uv once: curl -LsSf https://astral.sh/uv/install.sh | sh");
+  process.exit(1);
+}
+process.exit(res.status == null ? 1 : res.status);

package/package.json

@@ -1,6 +1,22 @@
 {
   "name": "@vernikr/gemini-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.8.1",
+  "description": "One-command Gemini free-tier MCP gateway: quota-aware model routing, massive-body chunked analysis, file ingest (RTF/DOCX→Markdown), async tickets. Thin bootstrap for the Python core gemini-mcp-gateway.",
+  "bin": {
+    "gemini-mcp": "bin/gemini-mcp.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vernikr/gemini-mcp.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}