- Works locally.

Author: general-kroll-4-life

.vscode/launch.json

@@ -380,6 +380,16 @@
         "true",
         "false"
       ]
+    },
+    {
+      "type": "pickString",
+      "id": "mcpServerType",
+      "description": "MCP server type",
+      "default": "stdio",
+      "options": [
+        "http",
+        "stdio"
+      ]
     }
   ],
   "configurations": [
@@ -465,6 +475,19 @@
         "--dbInternal=${input:dbInternalString}",
         "--export.alias=${input:exportAliasString}",
         "--pgsrv.debug.enable=${input:serverDebugPublish}",
+        "--mcp.server.type=${input:mcpServerType}",
+      ],
+    },
+    {
+      "name": "run MCP client",
+      "type": "go",
+      "request": "launch",
+      "envFile": "${workspaceFolder}/.vscode/.env",
+      "mode": "debug",
+      "program": "${workspaceFolder}/mcp_client/cmd",
+      "args": [
+        "exec",
+        "--client-type=http",
       ],
     },
     {

.vscode/mcp.json

@@ -60,6 +60,7 @@
       "args": [
         "mcp",
         "--tls.allowInsecure",
+        "--mcp.server.type=stdio",
         "--auth=${input:authString}",
         "--registry=${input:registryString}"
       ]

cicd/python/build.py

@@ -14,7 +14,7 @@ def build_stackql(verbose :bool) -> int:
     os.environ['BUILDMINORVERSION'] = os.environ.get('BUILDMINORVERSION', '1')
     os.environ['BUILDPATCHVERSION'] = os.environ.get('BUILDPATCHVERSION', '1')
     os.environ['CGO_ENABLED'] = os.environ.get('CGO_ENABLED', '1')
-    return subprocess.call(
+    rv = subprocess.call(
         f'go build {"-x -v" if verbose else ""} --tags "sqlite_stackql" -ldflags "-X github.com/stackql/stackql/internal/stackql/cmd.BuildMajorVersion={os.environ.get("BUILDMAJORVERSION")} '
         f'-X github.com/stackql/stackql/internal/stackql/cmd.BuildMinorVersion={os.environ.get("BUILDMINORVERSION")} '
         f'-X github.com/stackql/stackql/internal/stackql/cmd.BuildPatchVersion={os.environ.get("BUILDPATCHVERSION")} '
@@ -26,6 +26,14 @@ def build_stackql(verbose :bool) -> int:
         '-o build/ ./stackql',
         shell=True
     )
+    if rv != 0:
+        return rv
+    return subprocess.call(
+        'go build '
+        f'{"-x -v" if verbose else ""} '
+        '-o build/stackql_mcp_client ./mcp_client/cmd',
+        shell=True
+    )
 
 
 def unit_test_stackql(verbose :bool) -> int:
@@ -34,7 +42,7 @@ def unit_test_stackql(verbose :bool) -> int:
         shell=True
     )
 
-def sanitise_val(val :any) -> str:
+def sanitise_val(val) -> str:
     if isinstance(val, bool):
         return str(val).lower()
     return str(val)

internal/stackql/cmd/exec.go

@@ -1,5 +1,5 @@
 /*
-Copyright © 2019 stackql [email protected]
+Copyright © 2025 stackql [email protected]
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

internal/stackql/cmd/mcp.go

@@ -1,5 +1,5 @@
 /*
-Copyright © 2019 stackql [email protected]
+Copyright © 2025 stackql [email protected]
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -17,6 +17,7 @@ package cmd
 
 import (
 	"context"
+	"encoding/json"
 
 	"github.com/spf13/cobra"
 
@@ -26,6 +27,11 @@ import (
 	"github.com/stackql/stackql/pkg/mcp_server"
 )
 
+var (
+	mcpServerType string // overwritten by flag
+	mcpConfig     string // overwritten by flag
+)
+
 //nolint:gochecknoglobals // cobra pattern
 var mcpSrvCmd = &cobra.Command{
 	Use:   "mcp",
@@ -43,8 +49,11 @@ var mcpSrvCmd = &cobra.Command{
 		handlerCtx, err := entryutil.BuildHandlerContext(runtimeCtx, nil, queryCache, inputBundle, false)
 		iqlerror.PrintErrorAndExitOneIfError(err)
 		iqlerror.PrintErrorAndExitOneIfNil(handlerCtx, "handler context is unexpectedly nil")
+		var config mcp_server.Config
+		json.Unmarshal([]byte(mcpConfig), &config) //nolint:errcheck // TODO: investigate
+		config.Server.Transport = mcpServerType
 		server, serverErr := mcp_server.NewExampleBackendServer(
-			nil,
+			&config,
 			logging.GetLogger(),
 		)
 		// server, serverErr := mcp_server.NewExampleHTTPBackendServer(

internal/stackql/cmd/registry.go

@@ -1,5 +1,5 @@
 /*
-Copyright © 2019 stackql [email protected]
+Copyright © 2025 stackql [email protected]
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

internal/stackql/cmd/root.go

@@ -1,5 +1,5 @@
 /*
-Copyright © 2019 stackql [email protected]
+Copyright © 2025 stackql [email protected]
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -198,6 +198,9 @@ func init() {
 	rootCmd.AddCommand(registryCmd)
 	rootCmd.AddCommand(srvCmd)
 	rootCmd.AddCommand(mcpSrvCmd)
+
+	mcpSrvCmd.PersistentFlags().StringVar(&mcpConfig, "mcp.config", "{}", "MCP server config file path (YAML or JSON)")
+	mcpSrvCmd.PersistentFlags().StringVar(&mcpServerType, "mcp.server.type", "http", "MCP server type (http or stdio for now)")
 }
 
 func mergeConfigFromFile(runtimeCtx *dto.RuntimeCtx, flagSet pflag.FlagSet) {

internal/stackql/cmd/shell.go

@@ -1,5 +1,5 @@
 /*
-Copyright © 2019 stackql [email protected]
+Copyright © 2025 stackql [email protected]
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

internal/stackql/cmd/srv.go

@@ -1,5 +1,5 @@
 /*
-Copyright © 2019 stackql [email protected]
+Copyright © 2025 stackql [email protected]
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

mcp_client/.gitignore

@@ -0,0 +1,2 @@
+.stackql
+__debug_bin