jobescape-concierge 0.1.0__tar.gz

jobescape_concierge-0.1.0/.gitignore

@@ -0,0 +1,25 @@
+# Secrets & local state — never commit
+.env
+.env.*
+!.env.example
+*.json
+!**/.vscode/*.json
+chat_memory.db
+*.db
+*.csv
+result.csv
+*.egg-info/
+# Build artifacts
+dist/
+build/
+# Python
+__pycache__/
+**/__pycache__/
+*.pyc
+.venv/
+venv/
+.pytest_cache/
+
+# Editor
+.idea/
+.vscode/

jobescape_concierge-0.1.0/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: jobescape-concierge
+Version: 0.1.0
+Summary: Concierge text2sql MCP server — connects Claude (and other MCP clients) to the Concierge BigQuery assistant over stdio.
+Author-email: JobEscape <team@jobescape.me>
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: anyio>=4.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.28.1
+Description-Content-Type: text/markdown
+
+# jobescape-concierge
+
+Concierge text2sql MCP server. Connects Claude (and any MCP-compatible client) to the Concierge BigQuery assistant over stdio — no repo clone, no database or cloud credentials required.
+
+## Requirements
+
+- [`uv`](https://docs.astral.sh/uv/) installed (for `uvx`)
+- A Concierge API token (request one from the Concierge admin; tokens are tied to your `@nvs.team` email)
+
+## Add to Claude Desktop / Claude Code
+
+```bash
+claude mcp add concierge \
+  -e CONCIERGE_API_TOKEN=t2s_... \
+  -- uvx jobescape-concierge
+```
+
+Or edit `claude_desktop_config.json` directly:
+
+```json
+{
+  "mcpServers": {
+    "concierge": {
+      "command": "uvx",
+      "args": ["jobescape-concierge"],
+      "env": {
+        "CONCIERGE_API_TOKEN": "t2s_..."
+      }
+    }
+  }
+}
+```
+
+Replace `t2s_...` with your actual token, then fully quit and reopen Claude Desktop.
+
+## Local development
+
+Point the server at a locally running Concierge instance:
+
+```bash
+CONCIERGE_API_TOKEN=t2s_... CONCIERGE_MCP_URL=http://localhost:8080/mcp/ uvx jobescape-concierge
+```
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `CONCIERGE_API_TOKEN` | Yes | — | Plaintext API token (`t2s_...` prefix). |
+| `CONCIERGE_MCP_URL` | No | `https://concierge-yh7apzuicq-ue.a.run.app/mcp/` | Base URL for the Concierge MCP endpoint. Use a `localhost` URL for local dev. |
+
+## How it works
+
+On startup the server connects to the Concierge cloud MCP endpoint over HTTPS, validates your token, and fetches the available tool list. It then re-serves those tools over the MCP stdio protocol and forwards every tool call to the cloud. No SQL, schema, or credentials live in this package — all data access happens server-side.
+
+## License
+
+MIT

jobescape_concierge-0.1.0/README.md

@@ -0,0 +1,57 @@
+# jobescape-concierge
+
+Concierge text2sql MCP server. Connects Claude (and any MCP-compatible client) to the Concierge BigQuery assistant over stdio — no repo clone, no database or cloud credentials required.
+
+## Requirements
+
+- [`uv`](https://docs.astral.sh/uv/) installed (for `uvx`)
+- A Concierge API token (request one from the Concierge admin; tokens are tied to your `@nvs.team` email)
+
+## Add to Claude Desktop / Claude Code
+
+```bash
+claude mcp add concierge \
+  -e CONCIERGE_API_TOKEN=t2s_... \
+  -- uvx jobescape-concierge
+```
+
+Or edit `claude_desktop_config.json` directly:
+
+```json
+{
+  "mcpServers": {
+    "concierge": {
+      "command": "uvx",
+      "args": ["jobescape-concierge"],
+      "env": {
+        "CONCIERGE_API_TOKEN": "t2s_..."
+      }
+    }
+  }
+}
+```
+
+Replace `t2s_...` with your actual token, then fully quit and reopen Claude Desktop.
+
+## Local development
+
+Point the server at a locally running Concierge instance:
+
+```bash
+CONCIERGE_API_TOKEN=t2s_... CONCIERGE_MCP_URL=http://localhost:8080/mcp/ uvx jobescape-concierge
+```
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `CONCIERGE_API_TOKEN` | Yes | — | Plaintext API token (`t2s_...` prefix). |
+| `CONCIERGE_MCP_URL` | No | `https://concierge-yh7apzuicq-ue.a.run.app/mcp/` | Base URL for the Concierge MCP endpoint. Use a `localhost` URL for local dev. |
+
+## How it works
+
+On startup the server connects to the Concierge cloud MCP endpoint over HTTPS, validates your token, and fetches the available tool list. It then re-serves those tools over the MCP stdio protocol and forwards every tool call to the cloud. No SQL, schema, or credentials live in this package — all data access happens server-side.
+
+## License
+
+MIT

jobescape_concierge-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "jobescape-concierge"
+version = "0.1.0"
+description = "Concierge text2sql MCP server — connects Claude (and other MCP clients) to the Concierge BigQuery assistant over stdio."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+  { name = "JobEscape", email = "team@jobescape.me" },
+]
+dependencies = [
+  "mcp>=1.28.1",
+  "anyio>=4.0",
+  "httpx>=0.27",
+]
+
+[project.scripts]
+jobescape-concierge = "concierge_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/concierge_mcp"]

jobescape_concierge-0.1.0/src/concierge_mcp/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

jobescape_concierge-0.1.0/src/concierge_mcp/server.py

@@ -0,0 +1,113 @@
+"""Stdio MCP server — connects Claude (and other MCP clients) to the Concierge cloud.
+
+Run as:
+    CONCIERGE_API_TOKEN=t2s_... uvx jobescape-concierge
+
+This is a thin proxy. It holds no SQL, schema, or credentials: it opens an
+authenticated connection to the already-deployed Concierge MCP server over HTTPS,
+mirrors the tools that server exposes, and forwards every tool call to it over
+stdio. All the real work (table selection, RAG, BigQuery, chat memory) happens
+server-side in the cloud deployment.
+
+Environment variables:
+    CONCIERGE_API_TOKEN   Required. The plaintext API token (prefix t2s_...).
+    CONCIERGE_MCP_URL     Optional. Base URL for the Concierge MCP endpoint.
+                          Defaults to the production Cloud Run URL below.
+"""
+from __future__ import annotations
+
+import os
+import sys
+
+import anyio
+import httpx
+import mcp.server.stdio
+import mcp.types as types
+from mcp import ClientSession
+from mcp.client.streamable_http import streamable_http_client
+from mcp.server.lowlevel import Server
+
+DEFAULT_URL = "https://concierge-yh7apzuicq-ue.a.run.app/mcp/"
+
+
+async def _async_main() -> None:
+    token = os.environ.get("CONCIERGE_API_TOKEN", "").strip()
+    if not token:
+        print(
+            "ERROR: CONCIERGE_API_TOKEN environment variable is not set.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    url = os.environ.get("CONCIERGE_MCP_URL", DEFAULT_URL)
+
+    # The cloud server requires a valid Bearer token on EVERY HTTP request. Set it
+    # as a default header on the httpx client so it is attached to all requests
+    # (tool-call POSTs, the SSE GET stream, and the session-terminate DELETE).
+    auth_headers = {"Authorization": f"Bearer {token}"}
+    http_timeout = httpx.Timeout(30.0, read=300.0)
+
+    # Open one long-lived connection to the cloud MCP server for the whole
+    # lifetime of this process, then re-serve its tools locally over stdio.
+    try:
+        async with httpx.AsyncClient(
+            headers=auth_headers, timeout=http_timeout, follow_redirects=True
+        ) as http_client:
+            async with streamable_http_client(url, http_client=http_client) as (
+                read_stream,
+                write_stream,
+                _get_session_id,
+            ):
+                async with ClientSession(read_stream, write_stream) as client:
+                    init_result = await client.initialize()
+                    remote_tools = (await client.list_tools()).tools
+
+                    print(
+                        f"jobescape-concierge: connected to {url} "
+                        f"({len(remote_tools)} tools)",
+                        file=sys.stderr,
+                    )
+
+                    # Reuse the cloud server's own instructions so client guidance
+                    # (chat_memory_id handling, etc.) updates without re-publishing.
+                    instructions = getattr(init_result, "instructions", None)
+                    server = Server("concierge", instructions=instructions)
+
+                    @server.list_tools()
+                    async def handle_list_tools() -> list[types.Tool]:
+                        return [
+                            types.Tool(
+                                name=t.name,
+                                description=t.description,
+                                inputSchema=t.inputSchema,
+                            )
+                            for t in remote_tools
+                        ]
+
+                    @server.call_tool()
+                    async def handle_call_tool(
+                        name: str, arguments: dict | None
+                    ) -> list[types.ContentBlock]:
+                        result = await client.call_tool(name, arguments or {})
+                        return list(result.content)
+
+                    init_options = server.create_initialization_options()
+                    async with mcp.server.stdio.stdio_server() as (r, w):
+                        await server.run(r, w, init_options)
+    except SystemExit:
+        raise
+    except Exception as exc:
+        print(
+            f"ERROR: could not connect to Concierge at {url}: {exc}",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+
+def main() -> None:
+    """Console entry point — invoked by `jobescape-concierge` / `uvx jobescape-concierge`."""
+    anyio.run(_async_main)
+
+
+if __name__ == "__main__":
+    main()