mcp-server-improve

Summary:

- Better MCP server docs.

Author: general-kroll-4-life

.vscode/launch.json

@@ -188,6 +188,15 @@
       ], 
       "default": "show providers;"
     },
+    {
+      "type": "pickString",
+      "id": "mcpSrvCfgStr",
+      "description": "MCP Server Configuration",
+      "options": [
+        "{\"server\": {\"transport\": \"http\", \"address\": \"127.0.0.1:9992\"} }"
+      ],
+      "default": "{\"server\": {\"transport\": \"http\", \"address\": \"127.0.0.1:9992\"} }"
+    },
     {
       "type": "pickString",
       "id": "registryString",
@@ -385,7 +394,7 @@
       "type": "pickString",
       "id": "mcpServerType",
       "description": "MCP server type",
-      "default": "stdio",
+      "default": "http",
       "options": [
         "http",
         "stdio"
@@ -464,6 +473,8 @@
       "program": "${workspaceFolder}/stackql",
       "args": [
         "mcp",
+        "--mcp.server.type=${input:mcpServerType}",
+        "--mcp.config=${input:mcpSrvCfgStr}",
         "--pgsrv.port=6555",
         "--tls.allowInsecure",
         "--auth=${input:authString}",
@@ -475,7 +486,6 @@
         "--dbInternal=${input:dbInternalString}",
         "--export.alias=${input:exportAliasString}",
         "--pgsrv.debug.enable=${input:serverDebugPublish}",
-        "--mcp.server.type=${input:mcpServerType}",
       ],
     },
     {

docs/mcp.md

@@ -0,0 +1,30 @@
+
+## Running the MCP server
+
+
+```bash
+
+
+
+
+```
+
+
+## Using the MCP Client
+
+This is very much a development tool, not currently recommended for production.
+
+Build:
+
+```bash
+python cicd/python/build.py --build-mcp-client
+```
+
+Then, assuming you have a `stackql` MCP server serving streamable HTTP on port `9992`: 
+
+
+```bash
+
+./build/stackql_mcp_client exec --client-type=http  --url=http://127.0.0.1:9992 --exec.action      list_services --exec.args '{"provider": "google"}'
+
+```