@dynatrace-oss/dynatrace-mcp-server 0.2.0 → 0.3.0

package/README.md

@@ -16,9 +16,10 @@ Bring real-time observability data directly into your development workflow.
 
 - List and get [problem](https://www.dynatrace.com/hub/detail/problems/) details from your services (for example Kubernetes)
 - List and get security problems / [vulnerability](https://www.dynatrace.com/hub/detail/vulnerabilities/) details
-- Execute DQL(Dynatrace Query Language) like getting events or logs
+- Execute DQL (Dynatrace Query Language) and retrieve logs, events, spans and metrics
 - Send Slack messages (via Slack Connector)
 - Set up notification Workflow (via Dynatrace [AutomationEngine](https://docs.dynatrace.com/docs/discover-dynatrace/platform/automationengine))
+- Get more information about a monitored entity
 - Get Ownership of an entity
 
 ## Quickstart
@@ -27,6 +28,8 @@ Bring real-time observability data directly into your development workflow.
 
 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`.
 
+We recommend to always set it up for your current workspace instead of using it globally.
+
 **VS Code**
 
 ```json
@@ -34,6 +37,7 @@ You can add this MCP server (using STDIO) to your MCP Client like VS Code, Claud
   "servers": {
     "npx-dynatrace-mcp-server": {
       "command": "npx",
+      "cwd": "${workspaceFolder}",
       "args": ["-y", "@dynatrace-oss/dynatrace-mcp-server@latest"],
       "envFile": "${workspaceFolder}/.env"
     }
@@ -61,6 +65,7 @@ This only works if the config is stored in the current workspaces, e.g., `<your-
 ```
 
 **Claude Desktop**
+
 ```json
 {
   "mcpServers": {
@@ -80,6 +85,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-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": {
@@ -96,6 +102,8 @@ The [Amazon Q Developer CLI](https://docs.aws.amazon.com/amazonq/latest/qdevelop
 }
 ```
 
+This configuration should be stored in `<your-repo>/.amazonq/mcp.json`.
+
 ## Environment Variables
 
 A **Dynatrace OAuth Client** is needed to communicate with your Dynatrace Environment. Please follow the documentation about

package/dist/dynatrace-clients.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.callAppFunction = exports.createOAuthClient = void 0;
+exports.callAppFunction = exports.createOAuthClient = exports.ExtendedOauthClient = void 0;
 const http_client_1 = require("@dynatrace-sdk/http-client");
 const dt_app_1 = require("dt-app");
+const package_json_1 = require("../package.json");
 /**
  * Uses the provided oauth Client ID and Secret and requests a token
  * @param clientId - OAuth Client ID for Dynatrace
@@ -32,6 +33,26 @@ const requestToken = async (clientId, clientSecret, authUrl, scopes) => {
     // and return the JSON result, as it contains additional information
     return await res.json();
 };
+/**
+ * ExtendedOAuthClient that takes parameters for clientId, secret, scopes, environmentUrl, authUrl, and the version of the dynatrace-mcp-server
+ */
+class ExtendedOauthClient extends http_client_1._OAuthHttpClient {
+    userAgent;
+    constructor(config, userAgent) {
+        super(config);
+        this.userAgent = userAgent;
+    }
+    send(options) {
+        // add the user-agent header to the request
+        options.headers = {
+            ...options.headers,
+            'User-Agent': this.userAgent,
+        };
+        // call the parent send method
+        return super.send(options);
+    }
+}
+exports.ExtendedOauthClient = ExtendedOauthClient;
 /** Create an Oauth Client based on clientId, clientSecret, environmentUrl and scopes */
 const createOAuthClient = async (clientId, clientSecret, environmentUrl, scopes) => {
     if (!clientId) {
@@ -54,13 +75,14 @@ const createOAuthClient = async (clientId, clientSecret, environmentUrl, scopes)
         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({
+    const userAgent = `dynatrace-mcp-server/v${package_json_1.version} (${process.platform}-${process.arch})`;
+    return new ExtendedOauthClient({
         scopes,
         clientId,
         secret: clientSecret,
         environmentUrl,
         authUrl: ssoAuthUrl,
-    });
+    }, userAgent);
 };
 exports.createOAuthClient = createOAuthClient;
 /** Helper function to call an app-function via platform-api */

package/dist/index.js

@@ -7,6 +7,7 @@ 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");
 const zod_1 = require("zod");
+const package_json_1 = require("../package.json");
 const dynatrace_clients_1 = require("./dynatrace-clients");
 const list_vulnerabilities_1 = require("./capabilities/list-vulnerabilities");
 const list_problems_1 = require("./capabilities/list-problems");
@@ -68,10 +69,10 @@ const main = async () => {
     const { oauthClient, oauthClientSecret, dtEnvironment, slackConnectionId } = dynatraceEnv;
     // create an oauth-client
     const dtClient = await (0, dynatrace_clients_1.createOAuthClient)(oauthClient, oauthClientSecret, dtEnvironment, scopes);
-    console.error("Starting Dynatrace MCP Server...");
+    console.error(`Starting Dynatrace MCP Server v${package_json_1.version}...`);
     const server = new mcp_js_1.McpServer({
         name: "Dynatrace MCP Server",
-        version: "0.0.1", // ToDo: Read from package.json / hard-code?
+        version: package_json_1.version,
     }, {
         capabilities: {
             tools: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynatrace-oss/dynatrace-mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Model Context Protocol (MCP) server for Dynatrace",
   "keywords": [
     "Dynatrace",

package/dist/capabilities/get-monitored-entity-owner.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMonitoredEntityOwner = void 0;
-const get_monitored_entity_details_1 = require("./get-monitored-entity-details");
-const getMonitoredEntityOwner = async (dtClient, entityId) => {
-    const monitoredEntity = await (0, get_monitored_entity_details_1.getMonitoredEntityDetails)(dtClient, entityId);
-    const owner = monitoredEntity.tags?.find((tag) => {
-        return tag?.key === "owner";
-    });
-    return {
-        entity: monitoredEntity,
-        owner: owner?.value
-    };
-};
-exports.getMonitoredEntityOwner = getMonitoredEntityOwner;

package/dist/capabilities/workflow-operations.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.executeWorkflow = exports.deleteWorkflow = exports.getWorkflowDetails = exports.listWorkflows = void 0;
-const client_automation_1 = require("@dynatrace-sdk/client-automation");
-const listWorkflows = async (dtClient) => {
-    const workflowsClient = new client_automation_1.WorkflowsClient(dtClient);
-    return await workflowsClient.getWorkflows({});
-};
-exports.listWorkflows = listWorkflows;
-const getWorkflowDetails = async (dtClient, workflowId) => {
-    const workflowsClient = new client_automation_1.WorkflowsClient(dtClient);
-    return await workflowsClient.getWorkflow({ id: workflowId });
-};
-exports.getWorkflowDetails = getWorkflowDetails;
-const deleteWorkflow = async (dtClient, workflowId) => {
-    const workflowsClient = new client_automation_1.WorkflowsClient(dtClient);
-    return await workflowsClient.deleteWorkflow({ id: workflowId });
-};
-exports.deleteWorkflow = deleteWorkflow;
-const executeWorkflow = async (dtClient, workflowId, input) => {
-    const workflowsClient = new client_automation_1.WorkflowsClient(dtClient);
-    return await workflowsClient.runWorkflow({
-        id: workflowId,
-        body: input || {}
-    });
-};
-exports.executeWorkflow = executeWorkflow;

package/dist/dynatrace-oauth-client.js

@@ -1,55 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OAuthHttpClient = void 0;
-class OAuthHttpClient {
-    config;
-    oauthToken;
-    constructor(config) {
-        this.config = config;
-    }
-    async send(options) {
-        const { statusValidator = defaultStatusValidator } = options;
-        if (!this.oauthToken || this.oauthToken.isExpired()) {
-            this.oauthToken = await this.requestToken();
-        }
-        const requestBodyType = options.requestBodyType ?? 'json';
-        const url = new URL(options.url, this.config.environmentUrl);
-        const body = options.body !== undefined
-            ? await encodeRequestBody(options.body, requestBodyType)
-            : undefined;
-        const headers = {
-            ...applyContentTypeHeader(options.headers, requestBodyType),
-            Authorization: `${this.oauthToken.tokenType} ${this.oauthToken.accessToken}`,
-        };
-        const response = await send(url.toString(), {
-            method: options.method,
-            signal: options.abortSignal,
-            body,
-            headers,
-        });
-        const ok = statusValidator(response.status);
-        if (ok) {
-            return new HttpClientResponse(response);
-        }
-        else {
-            throw new HttpClientResponseError(response, { requestMethod: options.method });
-        }
-    }
-    async requestToken() {
-        const res = await send(this.config.authUrl, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/x-www-form-urlencoded',
-            },
-            body: new URLSearchParams({
-                grant_type: 'client_credentials',
-                client_id: this.config.clientId,
-                client_secret: this.config.secret,
-                scope: this.config.scopes.join(' '),
-            }),
-        });
-        const data = await res.json();
-        return new OAuthToken(data);
-    }
-}
-exports.OAuthHttpClient = OAuthHttpClient;

package/dist/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"root":["../src/dynatrace-clients.ts","../src/getDynatraceEnv.test.ts","../src/getDynatraceEnv.ts","../src/index.ts","../src/capabilities/create-workflow-for-problem-notification.ts","../src/capabilities/execute-dql.ts","../src/capabilities/find-monitored-entity-by-name.ts","../src/capabilities/get-events-for-cluster.ts","../src/capabilities/get-logs-for-entity.ts","../src/capabilities/get-monitored-entity-details.ts","../src/capabilities/get-ownership-information.ts","../src/capabilities/get-problem-details.ts","../src/capabilities/get-vulnerability-details.ts","../src/capabilities/list-problems.ts","../src/capabilities/list-vulnerabilities.ts","../src/capabilities/send-slack-message.ts","../src/capabilities/update-workflow.ts"],"version":"5.8.2"}