{"id":47892351,"url":"https://github.com/cockroachdb/cursor-plugin","last_synced_at":"2026-04-04T03:10:17.532Z","repository":{"id":343807553,"uuid":"1179018487","full_name":"cockroachdb/cursor-plugin","owner":"cockroachdb","description":"CockroachDB development plugin for Cursor","archived":false,"fork":false,"pushed_at":"2026-03-27T21:42:56.000Z","size":429,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-28T03:56:28.293Z","etag":null,"topics":["cockroach-cloud","cockroachdb","cursor","developer-tools"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cockroachdb.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-11T15:50:57.000Z","updated_at":"2026-03-27T21:43:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/cockroachdb/cursor-plugin","commit_stats":null,"previous_names":["cockroachdb/cursor-plugin"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cockroachdb/cursor-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cockroachdb%2Fcursor-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cockroachdb%2Fcursor-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cockroachdb%2Fcursor-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cockroachdb%2Fcursor-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cockroachdb","download_url":"https://codeload.github.com/cockroachdb/cursor-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cockroachdb%2Fcursor-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31385997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T01:22:39.193Z","status":"online","status_checked_at":"2026-04-04T02:00:07.569Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cockroach-cloud","cockroachdb","cursor","developer-tools"],"created_at":"2026-04-04T03:10:16.988Z","updated_at":"2026-04-04T03:10:17.525Z","avatar_url":"https://github.com/cockroachdb.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# CockroachDB Plugin for Cursor\n\n[![Release Please](https://github.com/cockroachdb/cursor-plugin/actions/workflows/release-please.yml/badge.svg)](https://github.com/cockroachdb/cursor-plugin/actions/workflows/release-please.yml)\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n\nThe CockroachDB plugin for [Cursor](https://cursor.com/) gives your AI coding agent direct access to CockroachDB databases — explore schemas, write optimized SQL, debug queries, and manage distributed clusters.\n\n## Installation\n\nIn Cursor, run:\n\n```\n/add-plugin cockroachdb\n```\n\nOr install from the [Cursor Marketplace](https://cursor.com/marketplace).\n\n### Prerequisites\n\nThis plugin connects to CockroachDB via MCP (Model Context Protocol). Choose the backend that fits your setup — see [MCP Backends](#mcp-backends) below.\n\nFor the **MCP Toolbox** backend (available now), install [MCP Toolbox for Databases](https://github.com/googleapis/genai-toolbox) (v0.27.0+):\n\n```bash\nbrew install mcp-toolbox\n```\n\n## Configuration\n\nSet environment variables for your CockroachDB connection:\n\n```bash\nexport COCKROACHDB_HOST=\"your-cluster-host\"\nexport COCKROACHDB_PORT=\"26257\"\nexport COCKROACHDB_USER=\"your-user\"\nexport COCKROACHDB_PASSWORD=\"your-password\"\nexport COCKROACHDB_DATABASE=\"your-database\"\nexport COCKROACHDB_SSLMODE=\"verify-full\"\n```\n\nFor CockroachDB Cloud, find connection details in the [Cloud Console](https://cockroachlabs.cloud/).\n\n## MCP Backends\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eMCP Toolbox\u003c/strong\u003e (self-hosted, any cluster) — Default\u003c/summary\u003e\n\nConnect to any CockroachDB cluster (Cloud, self-hosted, local) via [MCP Toolbox for Databases](https://github.com/googleapis/genai-toolbox).\n\n**Install:** `brew install mcp-toolbox` (v0.27.0+)\n\n**Run (stdio, default):** `toolbox --tools-file tools.yaml --stdio`\n\n**Run (HTTP):** `toolbox --tools-file tools.yaml --address 0.0.0.0:5000`\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eccloud CLI\u003c/strong\u003e (cluster lifecycle, backups, DR, networking)\u003c/summary\u003e\n\nThe [`ccloud` CLI](https://www.cockroachlabs.com/blog/cockroachdb-ai-agents-cli-database-automation/) is an agent-ready command-line tool for full cluster lifecycle management. AI agents call ccloud directly via shell commands (not MCP protocol) -- every command supports `-o json` for structured output.\n\n**Install:** `brew install cockroachdb/tap/ccloud`\n\n**Authenticate (interactive):** `ccloud auth login` (opens browser; supports SSO via OIDC/SAMLv2)\n\n**Authenticate (org-scoped):** `ccloud auth login --org {organization-label}`\n\n**Authenticate (headless/CI):** `ccloud auth login --no-redirect` or use a service account API key as a bearer token.\n\n**Example agent commands:**\n```bash\n# Provision\nccloud cluster create serverless my-cluster us-east-1 --cloud AWS -o json\nccloud cluster database create my-cluster myapp -o json\n\n# Connect\nccloud cluster connection-string my-cluster --database myapp --sql-user maxroach -o json\n# Composable: pipe into jq + psql\nccloud cluster connection-string my-cluster --database myapp --sql-user maxroach -o json \\\n  | jq -r '.connection_url' | xargs -I{} psql {} -c \"SELECT count(*) FROM users\"\n\n# Operate\nccloud cluster list -o json\nccloud cluster info my-cluster -o json\nccloud cluster backup config update my-cluster --frequency 60 --retention 60\n\n# Observe\nccloud audit list --limit 10 -o json\nccloud cluster versions -o json\nccloud cluster cmek get my-cluster -o json\n\n# Scale \u0026 DR\nccloud replication create --primary-cluster prod-east --standby-cluster dr-west\nccloud cluster networking allowlist list \u003ccluster-id\u003e -o json\n\n# Organize\nccloud folder create Production -o json\nccloud folder contents \u003cfolder-id\u003e -o json\n\n# Test resilience\nccloud cluster disruption set my-cluster --region us-east-1 --whole-region\n```\n\n**Coverage:** Provision, Connect, Operate, Observe, Scale \u0026 DR, Organize, Test resilience. See the [ccloud reference](https://www.cockroachlabs.com/docs/cockroachcloud/ccloud-reference) for full command list.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCockroachDB Cloud MCP Server\u003c/strong\u003e (OAuth/API key)\u003c/summary\u003e\n\nThe official [managed MCP server](https://www.cockroachlabs.com/blog/cockroachdb-ai-agents-managed-mcp-server/) is hosted by Cockroach Labs and requires no infrastructure setup. Authenticate via OAuth 2.1 (PKCE) or a service account API key. Read-only by default; write access requires explicit consent.\n\n**OAuth (recommended — opens browser for consent, scopes: `mcp:read`, `mcp:write`):**\n```json\n{\n  \"mcpServers\": {\n    \"cockroachdb-cloud\": {\n      \"type\": \"http\",\n      \"url\": \"https://cockroachlabs.cloud/mcp\",\n      \"headers\": {\n        \"mcp-cluster-id\": \"{your-cluster-id}\"\n      }\n    }\n  }\n}\n```\n\n**API Key (headless/autonomous agents):**\n```json\n{\n  \"mcpServers\": {\n    \"cockroachdb-cloud\": {\n      \"type\": \"http\",\n      \"url\": \"https://cockroachlabs.cloud/mcp\",\n      \"headers\": {\n        \"mcp-cluster-id\": \"{your-cluster-id}\",\n        \"Authorization\": \"Bearer {your-service-account-api-key}\"\n      }\n    }\n  }\n}\n```\n\nSee the [quickstart guide](https://www.cockroachlabs.com/docs/cockroachcloud/connect-to-the-cockroachdb-cloud-mcp-server) for detailed setup.\n\u003c/details\u003e\n\n## What's Included\n\n### MCP Backends\n\n| Backend                    | Status      | Transport       | Use Case                                                                                                                          |\n|----------------------------|-------------|-----------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `cockroachdb-toolbox`      | Active      | stdio           | Any CockroachDB cluster via [MCP Toolbox](https://github.com/googleapis/genai-toolbox)                                            |\n| `cockroachdb-cloud`        | Active      | Streamable HTTP | [Managed MCP Server](https://www.cockroachlabs.com/blog/cockroachdb-ai-agents-managed-mcp-server/) — CockroachDB Cloud (OAuth/API key) |\n| `cockroachdb-toolbox-http` | Available   | Streamable HTTP | MCP Toolbox remote/multi-user via HTTP                                                                                            |\n\n### CLI Tools\n\n| Tool              | Status | Use Case                                                                                                                                           |\n|-------------------|--------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ccloud`          | Active | [Agent-ready CLI](https://www.cockroachlabs.com/blog/cockroachdb-ai-agents-cli-database-automation/) — cluster lifecycle, backups, DR, networking, audit. Agents call directly via shell. |\n\n### Tools\n\n**MCP Toolbox** (self-hosted, any cluster):\n\n| Tool                       | Description                                      |\n|----------------------------|--------------------------------------------------|\n| `cockroachdb-execute-sql`  | Execute SQL statements (SELECT, DDL, DML)        |\n| `cockroachdb-list-schemas` | List all schemas in the database                 |\n| `cockroachdb-list-tables`  | List tables with columns, types, and constraints |\n\n**CockroachDB Cloud MCP** (managed, read tools):\n\n| Tool                    | Description                                 |\n|-------------------------|---------------------------------------------|\n| `list_clusters`         | List all accessible clusters                |\n| `get_cluster`           | Get detailed cluster information            |\n| `list_databases`        | List databases in the cluster               |\n| `list_tables`           | List tables in a database                   |\n| `get_table_schema`      | Get detailed schema for a table             |\n| `select_query`          | Execute a SELECT statement                  |\n| `explain_query`         | Execute an EXPLAIN statement                |\n| `show_running_queries`  | List currently executing queries            |\n\n**CockroachDB Cloud MCP** (managed, write tools — requires write consent):\n\n| Tool                    | Description                                 |\n|-------------------------|---------------------------------------------|\n| `create_database`       | Create a new database                       |\n| `create_table`          | Create a new table                          |\n| `insert_rows`           | Insert rows into a table                    |\n\n### Skills\n\nSkills are sourced from the [`cockroachdb-skills`](https://github.com/cockroachlabs/cockroachdb-skills) submodule — a single source of truth shared across CockroachDB agent integrations.\n\n### Rules\n\n| Rule                     | Applies To                                                        |\n|--------------------------|-------------------------------------------------------------------|\n| **SQL Patterns**         | UUID primary keys, indexing, transactions, CockroachDB SQL idioms |\n| **Application Patterns** | ORM configuration, retry logic, schema design, error handling     |\n\n## Development\n\nClone the repository:\n\n```bash\ngit clone https://github.com/cockroachdb/cursor-plugin.git\ncd cursor-plugin\n```\n\n### Project Structure\n\n```\n.cursor-plugin/plugin.json   # Plugin manifest\nskills/                       # Skills from cockroachdb-skills submodule\nrules/                        # 4 rule sets (.mdc files)\nmcp.json                      # MCP server definitions (Toolbox + Cloud MCP)\ntools.yaml                    # Toolbox source \u0026 tool configuration\nsubmodules/cockroachdb-skills # Shared skills submodule\nassets/logo.svg               # Plugin logo\n```\n\n## Releasing\n\nThis repo uses [Release Please](https://github.com/googleapis/release-please) for automated releases.\n\n1. Use [Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`) on `main`\n2. Release Please opens a Release PR with version bump and changelog\n3. Merge the Release PR to publish\n\n## Links\n\n- [CockroachDB Documentation](https://www.cockroachlabs.com/docs/)\n- [CockroachDB Cloud Console](https://cockroachlabs.cloud/)\n- [Managed MCP Server Blog Post](https://www.cockroachlabs.com/blog/cockroachdb-ai-agents-managed-mcp-server/)\n- [Cloud MCP Quickstart Guide](https://www.cockroachlabs.com/docs/cockroachcloud/connect-to-the-cockroachdb-cloud-mcp-server)\n- [ccloud CLI for AI Agents Blog Post](https://www.cockroachlabs.com/blog/cockroachdb-ai-agents-cli-database-automation/)\n- [ccloud CLI Reference](https://www.cockroachlabs.com/docs/cockroachcloud/ccloud-get-started)\n- [MCP Toolbox for Databases](https://github.com/googleapis/genai-toolbox)\n- [Report Issues](https://github.com/cockroachdb/cursor-plugin/issues)\n\n## License\n\n[Apache-2.0](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcockroachdb%2Fcursor-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcockroachdb%2Fcursor-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcockroachdb%2Fcursor-plugin/lists"}