chore: Add initial docs

Author: duwenxin99

CLOUD-SQL-SQLSERVER.md

@@ -0,0 +1,21 @@
+# Cloud SQL for SQL Server Extension
+
+This document provides instructions for the Gemini agent to assist users with the Cloud SQL for SQL Server extension.
+
+## Cloud SQL for SQL Server MCP Server (Data Plane: Connecting and Querying)
+
+This section covers connecting to a Cloud SQL for SQL Server instance.
+
+1. **Verify Environment Variables**: Before attempting to connect, confirm with the user that the following environment variables are set in the extension configuration or their shell environment.
+
+    * `CLOUD_SQL_MSSQL_PROJECT`: The GCP project ID.
+    * `CLOUD_SQL_MSSQL_REGION`: The region of your Cloud SQL instance.
+    * `CLOUD_SQL_MSSQL_INSTANCE`: The ID of your Cloud SQL instance.
+    * `CLOUD_SQL_MSSQL_DATABASE`: The name of the database to connect to.
+    * `CLOUD_SQL_MSSQL_IP_ADDRESS`: The IP address of the Cloud SQL instance.
+    * `CLOUD_SQL_MSSQL_USER`: The database username.
+    * `CLOUD_SQL_MSSQL_PASSWORD`: The password for the database user.
+
+2. **Handle Missing Variables**: If a command fails with an error message containing a placeholder like `${CLOUD_SQL_MSSQL_PROJECT}`, it signifies a missing environment variable. Inform the user which variable is missing and instruct them to set it.
+
+3. **Handle Permission Errors**: If you encounter permission errors, ensure the user has the **Cloud SQL Client** (`roles/cloudsql.client`) role and the correct database-level permissions.

README.md

@@ -0,0 +1,55 @@
+# Gemini CLI Extension - Cloud SQL for SQL Server
+
+This Gemini CLI extension provides a set of tools to interact with [Cloud SQL for SQL Server](https://cloud.google.com/sql/docs/sqlserver) instances. It allows you to manage your databases, execute queries, and explore schemas directly from the [Gemini CLI](https://google-gemini.github.io/gemini-cli/), using natural language prompts.
+
+## Features
+
+* **Integrated with Gemini CLI:** As a Google-developed extension, it integrates seamlessly into the Gemini CLI environment, making security an accessible part of your workflow.
+* **Connect to Cloud SQL for SQL Server:** Securely connect to your Cloud SQL for SQL Server instances.
+* **Explore Database Schema:** List databases, tables, views, and schemas.
+* **Query your Database:** Execute SQL queries against your database.
+
+## Supported Tools
+
+* `list_tables`
+* `execute_sql`
+
+## Prerequisites
+
+Before you begin, ensure you have the following:
+
+* [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed.
+* A Google Cloud project with the **Cloud SQL Admin API** enabled.
+* IAM Permissions
+
+## Installation
+
+To install the extension, use the `gemini extensions install` command:
+
+```bash
+gemini extensions install github.com/gemini-cli-extensions/cloud-sql-sqlserver.git
+```
+
+## Configuration
+
+* `CLOUD_SQL_MSSQL_PROJECT`: The GCP project ID.
+* `CLOUD_SQL_MSSQL_REGION`: The region of your Cloud SQL instance.
+* `CLOUD_SQL_MSSQL_INSTANCE`: The ID of your Cloud SQL instance.
+* `CLOUD_SQL_MSSQL_DATABASE`: The name of the database to connect to.
+* `CLOUD_SQL_MSSQL_IP_ADDRESS`: The IP address of the Cloud SQL instance.
+* `CLOUD_SQL_MSSQL_USER`: The database username.
+* `CLOUD_SQL_MSSQL_PASSWORD`: The password for the database user.
+
+## Usage
+
+* Provision Infrastructure
+* Explore Schemas and Data
+* Generate code
+
+## Security
+
+This extension executes commands against your Cloud SQL for SQL Server database. Always review the generated SQL queries before execution, especially for write operations.
+
+## Disclaimer
+
+This is not an officially supported Google product. This extension is under active development, and breaking changes may be introduced.

gemini-extension.json

@@ -0,0 +1,24 @@
+{
+  "name": "Cloud SQL for SQL Server",
+  "version": "0.1.0",
+  "description": "Connect to Cloud SQL for SQL Server",
+  "mcpServers": {
+    "Cloud SQL for SQL Server": {
+      "command": "${extensionPath}${/}toolbox",
+      "args": [
+        "--prebuilt",
+        "cloud-sql-mssql",
+        "--stdio"
+      ],
+      "env": {
+        "CLOUD_SQL_SQLSERVER_PROJECT": "${CLOUD_SQL_SQLSERVER_PROJECT}",
+        "CLOUD_SQL_SQLSERVER_REGION": "${CLOUD_SQL_SQLSERVER_REGION}",
+        "CLOUD_SQL_SQLSERVER_INSTANCE": "${CLOUD_SQL_SQLSERVER_INSTANCE}",
+        "CLOUD_SQL_SQLSERVER_DATABASE": "${CLOUD_SQL_SQLSERVER_DATABASE}",
+        "CLOUD_SQL_SQLSERVER_USER": "${CLOUD_SQL_SQLSERVER_USER}",
+        "CLOUD_SQL_SQLSERVER_PASSWORD": "${CLOUD_SQL_SQLSERVER_PASSWORD}"
+      }
+    }
+  },
+  "contextFileName": "CLOUD-SQL-SQLSERVER.md"
+}