feat: add gemini-extension.json to support Gemini CLI installation

README.md

@@ -230,9 +230,17 @@ You can also enable both ClickHouse and chDB simultaneously:
 }
 ```
 
-3. Locate the command entry for `uv` and replace it with the absolute path to the `uv` executable. This ensures that the correct version of `uv` is used when starting the server. On a mac, you can find this path using `which uv`.
+3. ## Usage with Gemini CLI
 
-4. Restart Claude Desktop to apply the changes.
+You can install and run the ClickHouse MCP server directly as a native extension using the Gemini CLI. This will automatically manage the environment and start the server when needed.
+
+```bash
+gemini extensions install [https://github.com/ClickHouse/mcp-clickhouse](https://github.com/ClickHouse/mcp-clickhouse)
+```
+
+4. Locate the command entry for `uv` and replace it with the absolute path to the `uv` executable. This ensures that the correct version of `uv` is used when starting the server. On a mac, you can find this path using `which uv`.
+
+5. Restart Claude Desktop to apply the changes.
 
 ### Optional Write Access
 

gemini-extension.json

@@ -0,0 +1,52 @@
+{
+  "name": "clickhouse",
+  "version": "1.0.0",
+  "description": "Connect Gemini to your ClickHouse database to query data and explore schemas.",
+  "mcpServers": {
+    "clickhouse": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--with",
+        "mcp-clickhouse",
+        "mcp-clickhouse"
+      ],
+      "env": {
+        "CLICKHOUSE_HOST": "${settings.CLICKHOUSE_HOST}",
+        "CLICKHOUSE_PORT": "${settings.CLICKHOUSE_PORT}",
+        "CLICKHOUSE_USER": "${settings.CLICKHOUSE_USER}",
+        "CLICKHOUSE_PASSWORD": "${settings.CLICKHOUSE_PASSWORD}"
+      }
+    }
+  },
+  "settings": [
+    {
+      "name": "CLICKHOUSE_HOST",
+      "type": "string",
+      "description": "The hostname of your ClickHouse database",
+      "default": "localhost",
+      "required": false
+    },
+    {
+      "name": "CLICKHOUSE_PORT",
+      "type": "string",
+      "description": "The port number (e.g., 8123 for local, 8443 for Cloud)",
+      "default": "8443",
+      "required": false
+    },
+    {
+      "name": "CLICKHOUSE_USER",
+      "type": "string",
+      "description": "Database username",
+      "default": "default",
+      "required": false
+    },
+    {
+      "name": "CLICKHOUSE_PASSWORD",
+      "type": "password",
+      "description": "Database password (input will be masked securely)",
+      "sensitive": true,
+      "required": true
+    }
+  ]
+}