@dynatrace-oss/dynatrace-mcp-server 0.1.3 → 0.1.4

package/README.md

@@ -25,7 +25,7 @@ Bring real-time observability data directly into your development workflow.
 
 **Work in progress**
 
-You can add this MCP server (using STDIO) to your MCP Client like VS Code, Claude, Cursor, Windsurf Github Copilot via the package `@dynatrace-oss/dynatrace-mcp-server`.
+You can add this MCP server (using STDIO) to your MCP Client like VS Code, Claude, Cursor, Amazon Q Developer CLI, Windsurf Github Copilot via the package `@dynatrace-oss/dynatrace-mcp-server`.
 
 **VS Code**
 
@@ -79,7 +79,7 @@ This only works if the config is stored in the current workspaces, e.g., `<your-
 
 **Amazon Q Developer CLI**
 
-The [Amazon Q Developer CLI](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-chat.html) provides an interactive chat experience directly in your terminal. You can ask questions, get help with AWS services, troubleshoot issues, and generate code snippets without leaving your command line environment.
+The [Amazon Q Developer CLI](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-configuration.html) provides an interactive chat experience directly in your terminal. You can ask questions, get help with AWS services, troubleshoot issues, and generate code snippets without leaving your command line environment.
 ```json
 {
   "mcpServers": {

package/dist/dynatrace-clients.js

@@ -3,7 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.callAppFunction = exports.createOAuthClient = void 0;
 const http_client_1 = require("@dynatrace-sdk/http-client");
 const dt_app_1 = require("dt-app");
-/** Uses the provided oauth Client ID and Secret and requests a token */
+/**
+ * Uses the provided oauth Client ID and Secret and requests a token
+ * @param clientId - OAuth Client ID for Dynatrace
+ * @param clientSecret - Oauth Client Secret for Dynatrace
+ * @param authUrl - SSO Authentication URL
+ * @param scopes - List of requested scopes
+ * @returns
+ */
 const requestToken = async (clientId, clientSecret, authUrl, scopes) => {
     const res = await fetch(authUrl, {
         method: 'POST',
@@ -17,9 +24,12 @@ const requestToken = async (clientId, clientSecret, authUrl, scopes) => {
             scope: scopes.join(' '),
         }),
     });
+    // check if the response was okay (HTTP 2xx) or not (HTTP 4xx or 5xx)
     if (!res.ok) {
+        // log the error
         console.error(`Failed to fetch token: ${res.status} ${res.statusText}`);
     }
+    // and return the JSON result, as it contains additional information
     return await res.json();
 };
 /** Create an Oauth Client based on clientId, clientSecret, environmentUrl and scopes */
@@ -39,8 +49,9 @@ const createOAuthClient = async (clientId, clientSecret, environmentUrl, scopes)
     console.error(`Using SSO auth URL: ${ssoAuthUrl}`);
     // try to request a token, just to verify that everything is set up correctly
     const tokenResponse = await requestToken(clientId, clientSecret, ssoAuthUrl, scopes);
-    if (tokenResponse.error && tokenResponse.error_description) {
-        throw new Error(`Failed to retrieve OAuth token: ${tokenResponse.error} - ${tokenResponse.error_description}`);
+    // in case we didn't get a token, or error / error_description / issueId is set, we throw an error
+    if (!tokenResponse.access_token || tokenResponse.error || tokenResponse.error_description || tokenResponse.issueId) {
+        throw new Error(`Failed to retrieve OAuth token (IssueId: ${tokenResponse.issueId}): ${tokenResponse.error} - ${tokenResponse.error_description}. Note: Your OAuth client is most likely not configured correctly.`);
     }
     console.error(`Successfully retrieved token from SSO!`);
     return new http_client_1._OAuthHttpClient({

package/dist/index.js

@@ -2,6 +2,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const client_platform_management_service_1 = require("@dynatrace-sdk/client-platform-management-service");
+const shared_errors_1 = require("@dynatrace-sdk/shared-errors");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const dotenv_1 = require("dotenv");
@@ -74,7 +75,7 @@ const main = async () => {
             tools: {},
         },
     });
-    // quick abstraction/wrapper to make it easier to reply with text
+    // quick abstraction/wrapper to make it easier for tools to reply text instead of JSON
     const tool = (name, description, paramsSchema, cb) => {
         const wrappedCb = async (args) => {
             try {
@@ -84,6 +85,24 @@ const main = async () => {
                 };
             }
             catch (error) {
+                // check if it's an error originating from the Dynatrace SDK / API Gateway and provide an appropriate message to the user
+                if ((0, shared_errors_1.isClientRequestError)(error)) {
+                    const e = error;
+                    let additionalErrorInformation = '';
+                    if (e.response.status == 403) {
+                        additionalErrorInformation = 'Note: Your user or service-user is most likely lacking the necessary permissions/scopes for this API Call.';
+                    }
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `Client Request Error: ${e.message} with HTTP status: ${e.response.status}. ${additionalErrorInformation} (body: ${JSON.stringify(e.body)})`
+                            }
+                        ],
+                        isError: true,
+                    };
+                }
+                // else: We don't know what kind of error happened - best-case we can provide error.message
+                console.log(error);
                 return {
                     content: [{ type: "text", text: `Error: ${error.message}` }],
                     isError: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynatrace-oss/dynatrace-mcp-server",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Model Context Protocol (MCP) server for Dynatrace",
   "keywords": [
     "Dynatrace",
@@ -45,6 +45,7 @@
     "@dynatrace-sdk/client-classic-environment-v2": "^3.6.8",
     "@dynatrace-sdk/client-platform-management-service": "^1.6.3",
     "@dynatrace-sdk/client-query": "^1.18.1",
+    "@dynatrace-sdk/shared-errors": "^1.0.0",
     "@modelcontextprotocol/sdk": "^1.8.0",
     "dotenv": "^16.4.7",
     "dt-app": "^0.140.1",