diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 5ff10ceb1..0683c2533 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -397,6 +397,11 @@ "name": "excalidraw", "source": "third_party/excalidraw", "description": "Draw and export hand-drawn diagrams from chat." + }, + { + "name": "google-cloud-bigquery", + "source": "third_party/google-cloud-bigquery", + "description": "Explore datasets and tables and run SQL queries." } ] } diff --git a/README.md b/README.md index 6cff83a32..777e787b4 100644 --- a/README.md +++ b/README.md @@ -80,6 +80,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc | `meltwater` | [Meltwater](third_party/meltwater/) | Cursor | Integrations | Search media and social mentions and pull analytics. | | `daloopa` | [Daloopa](third_party/daloopa/) | Cursor | Integrations | Pull source-linked fundamentals, KPIs, filings, and prices. | | `excalidraw` | [Excalidraw](third_party/excalidraw/) | Cursor | Integrations | Draw and export hand-drawn diagrams from chat. | +| `google-cloud-bigquery` | [Google Cloud BigQuery](third_party/google-cloud-bigquery/) | Cursor | Integrations | Explore datasets and tables and run SQL queries. | Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `plugins@cursor.com` in the manifest). ## Repository structure diff --git a/third_party/google-cloud-bigquery/.cursor-plugin/plugin.json b/third_party/google-cloud-bigquery/.cursor-plugin/plugin.json new file mode 100644 index 000000000..37ffa2837 --- /dev/null +++ b/third_party/google-cloud-bigquery/.cursor-plugin/plugin.json @@ -0,0 +1,36 @@ +{ + "name": "google-cloud-bigquery", + "displayName": "Google Cloud BigQuery", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.13.0" + }, + "description": "Explore datasets and tables and run SQL queries.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://docs.cloud.google.com/bigquery/docs/use-bigquery-mcp", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "google cloud bigquery", + "google cloud", + "bigquery", + "sql", + "analytics", + "data warehouse", + "datasets", + "mcp" + ], + "category": "integrations", + "tags": [ + "bigquery", + "google cloud", + "analytics", + "sql", + "mcp" + ], + "mcpServers": "./mcp.json" +} diff --git a/third_party/google-cloud-bigquery/CHANGELOG.md b/third_party/google-cloud-bigquery/CHANGELOG.md new file mode 100644 index 000000000..1789565cd --- /dev/null +++ b/third_party/google-cloud-bigquery/CHANGELOG.md @@ -0,0 +1,9 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Added the `google-cloud-bigquery` MCP server pointing at Google Cloud BigQuery's hosted Streamable HTTP endpoint (`https://bigquery.googleapis.com/mcp`). +- Auth uses OAuth with Google Cloud BigQuery user login — no API key or client ID to configure. +- Logo: Official BigQuery product icon from Google Cloud's architecture icon set, on a padded white tile. diff --git a/third_party/google-cloud-bigquery/LICENSE b/third_party/google-cloud-bigquery/LICENSE new file mode 100644 index 000000000..ca2bba771 --- /dev/null +++ b/third_party/google-cloud-bigquery/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Cursor + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/third_party/google-cloud-bigquery/README.md b/third_party/google-cloud-bigquery/README.md new file mode 100644 index 000000000..bedfbfe19 --- /dev/null +++ b/third_party/google-cloud-bigquery/README.md @@ -0,0 +1,61 @@ +# Google Cloud BigQuery + +Cursor plugin that connects agents to [Google Cloud BigQuery](https://docs.cloud.google.com/bigquery/docs/use-bigquery-mcp) through Google Cloud BigQuery's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server. + +Explore datasets and tables and run SQL queries. + +## Install + +1. Open **Cursor Settings → Plugins**. +2. Search for **Google Cloud BigQuery**. +3. Click **Install**, then complete the Google Cloud BigQuery sign-in prompt. + +Or run `/add-plugin google-cloud-bigquery` in chat. + +## MCP + +```json +{ + "mcpServers": { + "google-cloud-bigquery": { + "type": "http", + "url": "https://bigquery.googleapis.com/mcp" + } + } +} +``` + +Auth is OAuth. Cursor prompts for Google Cloud BigQuery sign-in when the plugin connects — there is no client ID or personal access token to configure. + +## Before you connect + +You need a Google Cloud project with the BigQuery API enabled, and your Google account needs the MCP Tool User role (`roles/mcp.toolUser`) plus BigQuery Job User and Data Viewer on that project. + +## What agents can do + +| Category | Capabilities | +| --- | --- | +| Explore | List datasets and tables and read their metadata and schemas | +| Query | Run read-only SQL, including BigQuery ML functions | +| Write | Run DML and DDL when the account allows it | +| Jobs | Poll results and cancel running query jobs | + +The hosted runtime is the source of truth for tool names and schemas. + +## Notes + +- Queries are billed to the project id passed to the tool. +- Admins can block the write-capable `execute_sql` tool with an IAM deny policy while leaving read-only queries available. +- Grok also offers this connector with service-identity auth; this plugin configures only the user OAuth flow. + +## Docs + +- Use the BigQuery MCP server: https://docs.cloud.google.com/bigquery/docs/use-bigquery-mcp +- Tools reference: https://docs.cloud.google.com/bigquery/docs/reference/mcp +- Server URL: https://bigquery.googleapis.com/mcp + +Logo is the official BigQuery product icon from Google Cloud's architecture icon set, on a padded white tile. + +## License + +MIT diff --git a/third_party/google-cloud-bigquery/assets/logo.png b/third_party/google-cloud-bigquery/assets/logo.png new file mode 100644 index 000000000..cb2ba563c Binary files /dev/null and b/third_party/google-cloud-bigquery/assets/logo.png differ diff --git a/third_party/google-cloud-bigquery/mcp.json b/third_party/google-cloud-bigquery/mcp.json new file mode 100644 index 000000000..4068482cc --- /dev/null +++ b/third_party/google-cloud-bigquery/mcp.json @@ -0,0 +1,8 @@ +{ + "mcpServers": { + "google-cloud-bigquery": { + "type": "http", + "url": "https://bigquery.googleapis.com/mcp" + } + } +}