@dynatrace-oss/dynatrace-mcp-server 1.5.0-beta.1 → 1.5.0-beta.2

package/README.md

@@ -43,8 +43,26 @@ Furthermore, you need to configure the URL to a Dynatrace environment:
 
 - `DT_ENVIRONMENT` (string, e.g., `https://abc12345.apps.dynatrace.com`) - URL to your Dynatrace Platform (do not use Dynatrace classic URLs like `abc12345.live.dynatrace.com`)
 
+Authentication will be handled via Authorization Code Flow in your browser, you don't need to define a Platform Token nor an OAuth Client to get started.
+
 Once you are done, we recommend looking into [example prompts](#-example-prompts-), like `Get all details of the entity 'my-service'` or `Show me error logs`. Please mind that these prompts lead to executing DQL statements which may incur [costs](#costs) in accordance to your licence.
 
+**VSCode**
+
+```json
+{
+  "servers": {
+    "npx-dynatrace-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"],
+      "env": {
+        "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com"
+      }
+    }
+  }
+}
+```
+
 ## Architecture
 
 ![Architecture](https://github.com/dynatrace-oss/dynatrace-mcp/blob/main/assets/dynatrace-mcp-arch.png?raw=true)
@@ -124,22 +142,6 @@ We recommend to always set it up for your current workspace instead of using it
 
 **VS Code**
 
-```json
-{
-  "servers": {
-    "npx-dynatrace-mcp-server": {
-      "command": "npx",
-      "cwd": "${workspaceFolder}",
-      "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"],
-      "envFile": "${workspaceFolder}/.env"
-    }
-  }
-}
-```
-
-Please note: In this config, [the `${workspaceFolder}` variable](https://code.visualstudio.com/docs/reference/variables-reference#_predefined-variables) is used.
-This only works if the config is stored in the current workspaces, e.g., `<your-repo>/.vscode/mcp.json`. Alternatively, this can also be stored in user-settings, and you can define `env` as follows:
-
 ```json
 {
   "servers": {
@@ -147,7 +149,7 @@ This only works if the config is stored in the current workspaces, e.g., `<your-
       "command": "npx",
       "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"],
       "env": {
-        "DT_ENVIRONMENT": ""
+        "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com"
       }
     }
   }
@@ -163,7 +165,7 @@ This only works if the config is stored in the current workspaces, e.g., `<your-
       "command": "npx",
       "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"],
       "env": {
-        "DT_ENVIRONMENT": ""
+        "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com"
       }
     }
   }
@@ -181,7 +183,7 @@ The [Amazon Q Developer CLI](https://docs.aws.amazon.com/amazonq/latest/qdevelop
       "command": "npx",
       "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"],
       "env": {
-        "DT_ENVIRONMENT": ""
+        "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com"
       }
     }
   }
@@ -201,7 +203,7 @@ The [Amazon Kiro](https://kiro.dev/) is an agentic IDE that helps you do your be
       "command": "npx",
       "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"],
       "env": {
-        "DT_ENVIRONMENT": ""
+        "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com"
       }
     }
   }
@@ -219,10 +221,11 @@ Using `gemini` CLI directly (recommended):
 ```bash
 gemini extensions install https://github.com/dynatrace-oss/dynatrace-mcp
 export DT_PLATFORM_TOKEN=... # optional
-export DT_ENVIRONMENT=https://...
 ```
 
-and verify that the server is running via
+The command will ask for the value Dynatrace Environment.
+
+Verify that the server is running via
 
 ```bash
 gemini mcp list
@@ -237,7 +240,7 @@ Or manually in your `~/.gemini/settings.json` or `.gemini/settings.json`:
       "command": "npx",
       "args": ["@dynatrace-oss/dynatrace-mcp-server@latest"],
       "env": {
-        "DT_ENVIRONMENT": ""
+        "DT_ENVIRONMENT": "https://abc12345.apps.dynatrace.com"
       },
       "timeout": 30000,
       "trust": false
@@ -325,7 +328,7 @@ When just providing `DT_ENVIRONMENT`, the local MCP server will try to open a br
 
 For more information about the other authentication methods, please have a look at the documentation about
 [creating a Platform Token in Dynatrace](https://docs.dynatrace.com/docs/manage/identity-access-management/access-tokens-and-oauth-clients/platform-tokens), as well as
-[creating an OAuth Client in Dynatrace](https://docs.dynatrace.com/docs/manage/identity-access-management/access-tokens-and-oauth-clients/oauth-clients) for advanced scenarios.
+[creating an OAuth Client in Dynatrace](https://docs.dynatrace.com/docs/manage/identity-access-management/access-tokens-and-oauth-clients/oauth-clients) for advanced scenarios (service-users, backend-to-backend communication).
 
 In addition, depending on the features you use, the following variables can be configured:
 
@@ -338,6 +341,7 @@ The MCP server honors system proxy settings for corporate environments:
 - `https_proxy` or `HTTPS_PROXY` (optional, string, e.g., `http://proxy.example.com:8080`) - Proxy server URL for HTTPS requests
 - `http_proxy` or `HTTP_PROXY` (optional, string, e.g., `http://proxy.example.com:8080`) - Proxy server URL for HTTP requests
 - `no_proxy` or `NO_PROXY` (optional, string, e.g., `localhost,127.0.0.1,.local`) - Comma-separated list of hostnames or domains that should bypass the proxy
+- `NODE_EXTRA_CA_CERTS` (optional, string, e.g., `C:\some-path\certificate.pem`) - When set, the well known "root" CAs (like VeriSign) will be extended with the extra certificates
 
 **Note:** The `no_proxy` environment variable is currently logged for informational purposes but not fully enforced by the underlying HTTP client. If you need to bypass the proxy for specific hosts, consider configuring your proxy server to handle these exclusions.
 

package/dist/index.js

@@ -521,7 +521,7 @@ const main = async () => {
     // Register the execute_dql tool with MCP App UI support.
     registerAppTool(server, 'execute_dql', {
         title: 'Execute DQL',
-        description: 'Get data like Logs, Metrics, Spans, Events, or Entity Data from Dynatrace GRAIL by executing a Dynatrace Query Language (DQL) statement. ' +
+        description: 'Get data like Logs, Metrics, Spans, Events, or Entity Data from Dynatrace Grail by executing a Dynatrace Query Language (DQL) statement. ' +
             'Use the "generate_dql_from_natural_language" tool upfront to generate or refine a DQL statement based on your request. ' +
             'To learn about possible fields available for filtering, use the query "fetch dt.semantic_dictionary.models | filter data_object == \\"logs\\""',
         inputSchema: {
@@ -565,17 +565,20 @@ const main = async () => {
         if (!response) {
             return 'DQL execution failed or returned no result.';
         }
-        let result = `📊 **DQL Query Results**\n\n`;
-        // Budget warning comes first if present
+        // Build warnings array for structured metadata
+        const warnings = [];
         if (response.budgetWarning) {
-            result += `${response.budgetWarning}\n\n`;
+            warnings.push(response.budgetWarning);
         }
+        // Build human-readable text result
+        let result = `📊 **DQL Query Results**\n\n`;
         // Cost and Performance Information
         if (response.scannedRecords !== undefined) {
             result += `- **Scanned Records:** ${response.scannedRecords.toLocaleString()}\n`;
         }
         if (response.scannedBytes !== undefined) {
-            const scannedGB = response.scannedBytes / (1000 * 1000 * 1000);
+            // calculate scanned gigabytes for better readability in warnings and result text
+            const scannedGB = response.scannedBytes !== undefined ? response.scannedBytes / (1000 * 1000 * 1000) : 0;
             result += `- **Scanned Bytes:** ${scannedGB.toFixed(2)} GB`;
             // Show budget status if available
             if (response.budgetState) {
@@ -591,38 +594,51 @@ const main = async () => {
             }
             result += '\n';
             if (scannedGB > 500) {
-                result += `    ⚠️ **Very High Data Usage Warning:** This query scanned ${scannedGB.toFixed(1)} GB of data, which may impact your Dynatrace consumption. Please take measures to optimize your query, like limiting the timeframe or selecting a bucket.\n`;
+                warnings.push(`Very High Data Usage: This query scanned ${scannedGB.toFixed(1)} GB of data, which may impact your Dynatrace consumption. Please take measures to optimize your query, like limiting the timeframe or selecting a bucket.`);
             }
             else if (scannedGB > 50) {
-                result += `    ⚠️ **High Data Usage Warning:** This query scanned ${scannedGB.toFixed(2)} GB of data, which may impact your Dynatrace consumption.\n`;
+                warnings.push(`High Data Usage: This query scanned ${scannedGB.toFixed(2)} GB of data, which may impact your Dynatrace consumption.`);
             }
-            else if (scannedGB > 5) {
+            // Add informational messages (not warnings) about data usage
+            else if (scannedGB > 5 && scannedGB <= 50) {
                 result += `    💡 **Moderate Data Usage:** This query scanned ${scannedGB.toFixed(2)} GB of data.\n`;
             }
             else if (response.scannedBytes === 0) {
                 result += `    💡 **No Data consumed:** This query did not consume any data.\n`;
             }
+            if (response.sampled) {
+                warnings.push('Sampling Used: Results may be approximate');
+            }
+            if (response.records.length === recordLimit) {
+                warnings.push(`Record Limit Reached: The result set was limited to ${recordLimit} records. Consider changing your query with a smaller timeframe, an aggregation or a more concise filter. Alternatively, increase the recordLimit if you expect more results.`);
+            }
         }
-        if (response.sampled !== undefined && response.sampled) {
-            result += `- **⚠️ Sampling Used:** Yes (results may be approximate)\n`;
-        }
-        if (response.records.length === recordLimit) {
-            result += `- **⚠️ Record Limit Reached:** The result set was limited to ${recordLimit} records. Consider changing your query with a smaller timeframe, an aggregation or a more concise filter. Alternatively, increase the recordLimit if you expect more results.\n`;
+        // Add all warnings to result
+        if (warnings.length > 0) {
+            result += '\n';
+            warnings.forEach((warning) => {
+                result += `- **⚠️ ${warning}**\n`;
+            });
         }
         result += `\n📋 **Query Results**: (${response.records?.length || 0} records):\n\n`;
         result += `\`\`\`json\n${JSON.stringify(response.records, null, 2)}\n\`\`\``;
-        // Include field type definitions for chart rendering in the UI
-        if (response.types && response.types.length > 0) {
-            result += `\n\n📊 **Field Types**:\n\n`;
-            result += `\`\`\`json:types\n${JSON.stringify(response.types)}\n\`\`\``;
-        }
-        // Include analysisTimeframe metadata for chart rendering in the UI.
-        // This is needed when timeseries results lack explicit timeframe/interval
-        // columns (e.g. timeseries queries with fieldsRemove or custom projections).
-        if (response.metadata?.grail?.analysisTimeframe) {
-            result += `\n\n\`\`\`json:analysisTimeframe\n${JSON.stringify(response.metadata.grail.analysisTimeframe)}\n\`\`\``;
-        }
-        return result;
+        // Return structured data in _meta for MCP App UI instead of embedding in text
+        return {
+            text: result,
+            _meta: {
+                records: response.records,
+                types: response.types,
+                analysisTimeframe: response.metadata?.grail?.analysisTimeframe,
+                scannedRecords: response.scannedRecords,
+                scannedBytes: response.scannedBytes,
+                sampled: response.sampled,
+                environmentUrl: dtEnvironment,
+                budgetState: response.budgetState,
+                warnings,
+                recordLimit,
+                recordLimitReached: response.records.length === recordLimit,
+            },
+        };
     }));
     // MCP App: Register the HTML resource for the execute_dql interactive UI (MCP App)
     registerAppResource(server, 'DQL Results Viewer', executeDqlResourceUri, {}, async () => {