@octopusdeploy/mcp-server 0.1.2

package/dist/helpers/vcsProjectHelpers.js

@@ -0,0 +1,21 @@
+import {} from "@octopusdeploy/api-client";
+import {} from "../types/gitBranchTypes.js";
+export async function getProjectBranches(client, spaceId, projectId, options) {
+    const queryParams = {};
+    if (options?.searchByName) {
+        queryParams.searchByName = options.searchByName;
+    }
+    if (options?.skip !== undefined) {
+        queryParams.skip = options.skip.toString();
+    }
+    if (options?.take !== undefined) {
+        queryParams.take = options.take.toString();
+    }
+    const result = await client.get("~/api/{spaceId}/projects/{projectId}/git/branches{?skip,take,searchByName}", {
+        spaceId,
+        projectId,
+        ...queryParams,
+    });
+    return result;
+}
+//# sourceMappingURL=vcsProjectHelpers.js.map

package/dist/helpers/vcsProjectHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vcsProjectHelpers.js","sourceRoot":"","sources":["../../src/helpers/vcsProjectHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAkD,MAAM,4BAA4B,CAAC;AAE5F,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,OAAe,EACf,SAAiB,EACjB,OAAmC;IAEnC,MAAM,WAAW,GAA2B,EAAE,CAAC;IAE/C,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;QAC1B,WAAW,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAClD,CAAC;IAED,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,WAAW,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,WAAW,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAC7B,4EAA4E,EAC5E;QACE,OAAO;QACP,SAAS;QACT,GAAG,WAAW;KACf,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare const SEMVER_VERSION: string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAcA,eAAO,MAAM,cAAc,QAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerTools } from "./tools/index.js";
+import { Command } from "commander";
+import dotenv from "dotenv";
+import { createToolsetConfig } from "./utils/parseConfig.js";
+import { DEFAULT_TOOLSETS } from "./types/toolConfig.js";
+import { getClientConfigurationFromEnvironment } from "./helpers/getClientConfigurationFromEnvironment.js";
+import { setClientInfo } from "./utils/clientInfo.js";
+import { logger } from "./utils/logger.js";
+import packageJson from "../package.json" with { type: "json" };
+export const SEMVER_VERSION = packageJson.version;
+dotenv.config({ quiet: true });
+// Parse command line arguments
+const program = new Command();
+program
+    .name("octopus-mcp-server")
+    .description("Octopus Deploy MCP Server")
+    .version(SEMVER_VERSION)
+    .option("-s, --server-url <url>", "Octopus server URL")
+    .option("-k, --api-key <key>", "Octopus API key")
+    .option("--toolsets <toolsets>", `Comma-separated list of toolsets to enable, or "all" (default: all). Available toolsets: ${DEFAULT_TOOLSETS.join(", ")}`)
+    .option("--read-only", "Enable read-only mode (default: enabled)", true)
+    .option("--log-level <level>", "Minimum log level (info, error)", "info")
+    .option("--log-file <path>", "Log file path or filename (default: mcp-server-log.txt)")
+    .option("-q, --quiet", "Disable file logging, only log errors to console", false)
+    .parse();
+const options = program.opts();
+// Configure logger based on command line options
+if (options.logFile) {
+    logger.setLogFilePath(options.logFile);
+}
+logger.setLogLevel(logger.parseLogLevel(options.logLevel));
+logger.setQuietMode(options.quiet);
+// Pass CLI options to tools registration
+if (options.serverUrl) {
+    process.env.CLI_SERVER_URL = options.serverUrl;
+}
+if (options.apiKey) {
+    process.env.CLI_API_KEY = options.apiKey;
+}
+// Test configuration
+getClientConfigurationFromEnvironment();
+// Create toolset configuration
+const toolsetConfig = createToolsetConfig(options.toolsets, options.readOnly);
+const server = new McpServer({
+    name: "Octopus Deploy",
+    description: "Official Octopus Deploy MCP server.",
+    version: SEMVER_VERSION,
+});
+// Set up initialization callback to capture client info
+server.server.oninitialized = () => {
+    const clientInfo = server.server.getClientVersion();
+    if (clientInfo) {
+        setClientInfo(clientInfo.name, clientInfo.version);
+        logger.info(`Client initialized: ${clientInfo.name} v${clientInfo.version}`);
+    }
+    else {
+        logger.info("Client initialized but no client info available");
+    }
+};
+registerTools(server, toolsetConfig);
+logger.info(`Starting Octopus Deploy MCP server (version: ${SEMVER_VERSION})`);
+// Start server
+async function runServer() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+runServer().catch((error) => {
+    logger.error(`Fatal error running server: ${error.message}\n${error.stack}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/resources/index.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerResources(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QAClD"}

package/dist/resources/index.js

@@ -0,0 +1,4 @@
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+export function registerResources(server) {
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AAEzE,MAAM,UAAU,iBAAiB,CAAC,MAAiB;AACnD,CAAC"}

package/dist/resources/spacesResource.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSpacesResource(server: McpServer): void;
+//# sourceMappingURL=spacesResource.d.ts.map

package/dist/resources/spacesResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacesResource.d.ts","sourceRoot":"","sources":["../../src/resources/spacesResource.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAEV,MAAM,yCAAyC,CAAC;AAIjD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QA0DvD"}

package/dist/resources/spacesResource.js

@@ -0,0 +1,54 @@
+import { McpServer, ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { Client, SpaceRepository } from "@octopusdeploy/api-client";
+export function registerSpacesResource(server) {
+    const config = getClientConfigurationFromEnvironment();
+    const instanceURL = new URL(config.instanceURL);
+    server.resource("octopus_space", new ResourceTemplate(`octopus://${instanceURL.host}/spaces/{name}`, {
+        list: async () => {
+            const configuration = getClientConfigurationFromEnvironment();
+            const client = await Client.create(configuration);
+            const spaceRepository = new SpaceRepository(client);
+            const spacesResponse = await spaceRepository.list({});
+            return {
+                resources: spacesResponse.Items.map((space) => {
+                    return {
+                        uri: `octopus://${instanceURL.host}/spaces/${space.Name}`,
+                        name: space.Name,
+                        description: space.Description || "",
+                    };
+                }),
+            };
+        },
+        complete: {
+            name: async (name) => {
+                const configuration = getClientConfigurationFromEnvironment();
+                const client = await Client.create(configuration);
+                const spaceRepository = new SpaceRepository(client);
+                const spaces = await spaceRepository.list({ partialName: name });
+                return spaces.Items.map((space) => space.Name);
+            },
+        },
+    }), {}, async (uri, { name }) => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const spaceRepository = new SpaceRepository(client);
+        const partialName = Array.isArray(name) ? name[0] : name;
+        const decodedName = decodeURIComponent(partialName);
+        const spaces = await spaceRepository.list({ partialName: decodedName });
+        if (spaces.Items.length === 0) {
+            throw new Error(`Space with name '${partialName}' not found`);
+        }
+        const space = spaces.Items[0];
+        return {
+            contents: [
+                {
+                    uri: uri.toString(),
+                    text: JSON.stringify(space),
+                    mimeType: "application/json",
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=spacesResource.js.map

package/dist/resources/spacesResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacesResource.js","sourceRoot":"","sources":["../../src/resources/spacesResource.ts"],"names":[],"mappings":"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"}

package/dist/tools/getBranches.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetBranchesTool(server: McpServer): void;
+//# sourceMappingURL=getBranches.d.ts.map

package/dist/tools/getBranches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBranches.d.ts","sourceRoot":"","sources":["../../src/tools/getBranches.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,QAmDxD"}

package/dist/tools/getBranches.js

@@ -0,0 +1,55 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { getProjectBranches } from "../helpers/vcsProjectHelpers.js";
+export function registerGetBranchesTool(server) {
+    server.tool("get_branches", `Get Git branches for a version-controlled project
+
+This tool retrieves Git branches for a specific project in a space. The space name and project ID are required. Optionally provide searchByName, skip, and take parameters for filtering and pagination.`, {
+        spaceName: z.string(),
+        projectId: z.string(),
+        searchByName: z.string().optional(),
+        skip: z.number().optional(),
+        take: z.number().optional(),
+    }, {
+        title: "Get Git branches for a version-controlled project",
+        readOnlyHint: true,
+    }, async ({ spaceName, projectId, searchByName, skip, take }) => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const spaceId = await resolveSpaceId(client, spaceName);
+        const options = {
+            searchByName,
+            skip,
+            take,
+        };
+        const branches = await getProjectBranches(client, spaceId, projectId, options);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        Items: branches.Items.map(branch => ({
+                            Name: branch.Name,
+                            IsProtected: branch.IsProtected,
+                            CanonicalName: branch.CanonicalName,
+                        })),
+                        TotalResults: branches.TotalResults,
+                        ItemsPerPage: branches.ItemsPerPage,
+                        NumberOfPages: branches.NumberOfPages,
+                        LastPageNumber: branches.LastPageNumber,
+                        ItemType: branches.ItemType,
+                    }),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "get_branches",
+    config: { toolset: "context", readOnly: true },
+    registerFn: registerGetBranchesTool
+});
+//# sourceMappingURL=getBranches.js.map

package/dist/tools/getBranches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBranches.js","sourceRoot":"","sources":["../../src/tools/getBranches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACT,cAAc,EACd;;yMAEqM,EACrM;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B,EACD;QACE,KAAK,EAAE,mDAAmD;QAC1D,YAAY,EAAE,IAAI;KACnB,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QAC3D,MAAM,aAAa,GAAG,qCAAqC,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAExD,MAAM,OAAO,GAAG;YACd,YAAY;YACZ,IAAI;YACJ,IAAI;SACL,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAE/E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;4BACnC,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,WAAW,EAAE,MAAM,CAAC,WAAW;4BAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;yBACpC,CAAC,CAAC;wBACH,YAAY,EAAE,QAAQ,CAAC,YAAY;wBACnC,YAAY,EAAE,QAAQ,CAAC,YAAY;wBACnC,aAAa,EAAE,QAAQ,CAAC,aAAa;wBACrC,cAAc,EAAE,QAAQ,CAAC,cAAc;wBACvC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;qBAC5B,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC;IACrB,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9C,UAAU,EAAE,uBAAuB;CACpC,CAAC,CAAC"}

package/dist/tools/getCurrentUser.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetCurrentUserTool(server: McpServer): void;
+//# sourceMappingURL=getCurrentUser.d.ts.map

package/dist/tools/getCurrentUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCurrentUser.d.ts","sourceRoot":"","sources":["../../src/tools/getCurrentUser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAezE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,QAsC3D"}

package/dist/tools/getCurrentUser.js

@@ -0,0 +1,40 @@
+import { Client } from "@octopusdeploy/api-client";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+export function registerGetCurrentUserTool(server) {
+    server.tool("get_current_user", `Get information about the current authenticated user
+
+This tool retrieves information about the currently authenticated user from the Octopus Deploy API.`, {}, {
+        title: "Get current user information",
+        readOnlyHint: true,
+    }, async () => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const user = await client.get("~/api/users/me");
+        const currentUser = {
+            id: user.Id,
+            username: user.Username,
+            displayName: user.DisplayName,
+            isActive: user.IsActive,
+            isService: user.IsService,
+            emailAddress: user.EmailAddress,
+            canPasswordBeEdited: user.CanPasswordBeEdited,
+            isRequestor: user.IsRequestor,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(currentUser),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "get_current_user",
+    config: { toolset: "context", readOnly: true },
+    registerFn: registerGetCurrentUserTool
+});
+//# sourceMappingURL=getCurrentUser.js.map

package/dist/tools/getCurrentUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCurrentUser.js","sourceRoot":"","sources":["../../src/tools/getCurrentUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAa5G,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB;;oGAEgG,EAChG,EAAE,EACF;QACE,KAAK,EAAE,8BAA8B;QACrC,YAAY,EAAE,IAAI;KACnB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,aAAa,GAAG,qCAAqC,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAElD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAc,gBAAgB,CAAC,CAAC;QAE7D,MAAM,WAAW,GAAG;YAClB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;YAC7C,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;iBAClC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC;IACrB,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9C,UAAU,EAAE,0BAA0B;CACvC,CAAC,CAAC"}

package/dist/tools/getDeploymentProcess.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetDeploymentProcessTool(server: McpServer): void;
+//# sourceMappingURL=getDeploymentProcess.d.ts.map

package/dist/tools/getDeploymentProcess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploymentProcess.d.ts","sourceRoot":"","sources":["../../src/tools/getDeploymentProcess.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,QA6FjE"}

package/dist/tools/getDeploymentProcess.js

@@ -0,0 +1,91 @@
+import { Client, resolveSpaceId, ProjectRepository } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import {} from "../types/deploymentProcessTypes.js";
+import { getProjectBranches } from "../helpers/vcsProjectHelpers.js";
+export function registerGetDeploymentProcessTool(server) {
+    server.tool("get_deployment_process", `Get deployment process by ID
+
+This tool retrieves a deployment process by its ID. Each project has a deployment process attached, and releases/deployments can also have frozen processes attached.`, {
+        spaceName: z.string(),
+        projectId: z.string().optional().describe("The ID of the project to retrieve the deployment process for. If processId is not provided, this parameter is required."),
+        processId: z.string().optional().describe("The ID of the deployment process to retrieve. If not provided, the deployment process for the project will be retrieved."),
+        branchName: z.string().optional().describe("Optional branch name to get the deployment process for a specific branch (if using version controlled projects). Try `main` or `master` if unsure."),
+        includeDetails: z.boolean().optional().default(false).describe("Include detailed properties for steps and actions. Defaults to false."),
+    }, {
+        title: "Get deployment process details from Octopus Deploy",
+        readOnlyHint: true,
+    }, async ({ spaceName, processId, projectId, branchName, includeDetails = false }) => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const spaceId = await resolveSpaceId(client, spaceName);
+        const projectRepository = projectId ? new ProjectRepository(client, spaceName) : null;
+        const project = projectRepository && projectId ? await projectRepository.get(projectId) : null;
+        if (!processId && !projectId) {
+            throw new Error("Either processId or projectId must be provided.");
+        }
+        if (project?.IsVersionControlled && !branchName) {
+            throw new Error("Branch name must be provided for version controlled projects.");
+        }
+        // If using branchName get the canonical ref first
+        const branches = branchName && projectId && await getProjectBranches(client, spaceId, projectId, { take: 1, searchByName: branchName });
+        const gitRef = branches && branches.Items.length > 0 ? branches.Items[0].CanonicalName : undefined;
+        const url = gitRef
+            ? `~/api/{spaceId}/projects/{projectId}/{gitRef}/deploymentprocesses`
+            : `~/api/{spaceId}/deploymentprocesses/{processId}`;
+        const response = await client.get(url, {
+            spaceId,
+            projectId,
+            processId,
+            gitRef
+        });
+        const deploymentProcess = {
+            spaceId: response.SpaceId,
+            id: response.Id,
+            projectId: response.ProjectId,
+            version: response.Version,
+            lastSnapshotId: response.LastSnapshotId,
+            steps: response.Steps.map((step) => {
+                const mappedStep = {
+                    id: step.Id,
+                    name: step.Name,
+                    condition: step.Condition,
+                    startTrigger: step.StartTrigger,
+                    packageRequirement: step.PackageRequirement,
+                    ...(includeDetails && { properties: step.Properties }),
+                    actions: step.Actions.map((action) => {
+                        if (includeDetails) {
+                            return action;
+                        }
+                        else {
+                            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                            const { Properties, ...actionWithoutProperties } = action;
+                            return actionWithoutProperties;
+                        }
+                    }),
+                };
+                return mappedStep;
+            }),
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Retrieved deployment process with ID '${deploymentProcess.id}' in space '${spaceName}'${branchName ? ` for branch '${branchName}'` : ""}.`,
+                },
+                {
+                    type: "text",
+                    text: JSON.stringify(deploymentProcess),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "get_deployment_process",
+    config: { toolset: "projects", readOnly: true },
+    registerFn: registerGetDeploymentProcessTool
+});
+//# sourceMappingURL=getDeploymentProcess.js.map

package/dist/tools/getDeploymentProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploymentProcess.js","sourceRoot":"","sources":["../../src/tools/getDeploymentProcess.ts"],"names":[],"mappings":"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"}

package/dist/tools/getDeploymentTarget.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetDeploymentTargetTool(server: McpServer): void;
+//# sourceMappingURL=getDeploymentTarget.d.ts.map

package/dist/tools/getDeploymentTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploymentTarget.d.ts","sourceRoot":"","sources":["../../src/tools/getDeploymentTarget.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,QAiEhE"}

package/dist/tools/getDeploymentTarget.js

@@ -0,0 +1,66 @@
+import { Client, resolveSpaceId } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import {} from "../types/deploymentTargetTypes.js";
+export function registerGetDeploymentTargetTool(server) {
+    server.tool("get_deployment_target", `Get a specific deployment target (machine) by ID
+
+This tool retrieves detailed information about a specific deployment target using its ID. The space name and target ID are both required.`, {
+        spaceName: z.string(),
+        targetId: z.string(),
+    }, {
+        title: "Get a specific deployment target from an Octopus Deploy space",
+        readOnlyHint: true,
+    }, async ({ spaceName, targetId }) => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const spaceId = await resolveSpaceId(client, spaceName);
+        const target = await client.get("~/api/{spaceId}/machines/{id}", {
+            spaceId,
+            id: targetId,
+        });
+        const deploymentTarget = {
+            spaceId: target.SpaceId,
+            id: target.Id,
+            name: target.Name,
+            slug: target.Slug,
+            isDisabled: target.IsDisabled,
+            healthStatus: target.HealthStatus,
+            statusSummary: target.StatusSummary,
+            environmentIds: target.EnvironmentIds,
+            roles: target.Roles,
+            tenantedDeploymentParticipation: target.TenantedDeploymentParticipation,
+            tenantIds: target.TenantIds,
+            tenantTags: target.TenantTags,
+            endpoint: {
+                id: target.Endpoint.Id,
+                communicationStyle: target.Endpoint.CommunicationStyle,
+                uri: target.Endpoint.Uri,
+                fingerprint: target.Endpoint.Fingerprint,
+                proxyId: target.Endpoint.ProxyId,
+                tentacleVersionDetails: target.Endpoint.TentacleVersionDetails,
+            },
+            shellName: target.ShellName,
+            machinePolicyId: target.MachinePolicyId,
+            hasLatestCalamari: target.HasLatestCalamari,
+            isInProcess: target.IsInProcess,
+            links: target.Links,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(deploymentTarget),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "get_deployment_target",
+    config: { toolset: "machines", readOnly: true },
+    registerFn: registerGetDeploymentTargetTool
+});
+//# sourceMappingURL=getDeploymentTarget.js.map

package/dist/tools/getDeploymentTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeploymentTarget.js","sourceRoot":"","sources":["../../src/tools/getDeploymentTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAkB,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qCAAqC,EAAE,MAAM,qDAAqD,CAAC;AAC5G,OAAO,EAAiC,MAAM,mCAAmC,CAAC;AAElF,MAAM,UAAU,+BAA+B,CAAC,MAAiB;IAC/D,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB;;0IAEsI,EACtI;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,EACD;QACE,KAAK,EAAE,+DAA+D;QACtE,YAAY,EAAE,IAAI;KACnB,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE;QAChC,MAAM,aAAa,GAAG,qCAAqC,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAExD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAC7B,+BAA+B,EAC/B;YACE,OAAO;YACP,EAAE,EAAE,QAAQ;SACb,CACF,CAAC;QAEF,MAAM,gBAAgB,GAAG;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,+BAA+B,EAAE,MAAM,CAAC,+BAA+B;YACvE,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE;gBACR,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;gBACtB,kBAAkB,EAAE,MAAM,CAAC,QAAQ,CAAC,kBAAkB;gBACtD,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG;gBACxB,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW;gBACxC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;gBAChC,sBAAsB,EAAE,MAAM,CAAC,QAAQ,CAAC,sBAAsB;aAC/D;YACD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC;iBACvC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,sBAAsB,CAAC;IACrB,QAAQ,EAAE,uBAAuB;IACjC,MAAM,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC/C,UAAU,EAAE,+BAA+B;CAC5C,CAAC,CAAC"}

package/dist/tools/getKubernetesLiveStatus.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetKubernetesLiveStatusTool(server: McpServer): void;
+//# sourceMappingURL=getKubernetesLiveStatus.d.ts.map

package/dist/tools/getKubernetesLiveStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getKubernetesLiveStatus.d.ts","sourceRoot":"","sources":["../../src/tools/getKubernetesLiveStatus.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,SAAS,QAiEpE"}

package/dist/tools/getKubernetesLiveStatus.js

@@ -0,0 +1,64 @@
+import { Client, ObservabilityRepository } from "@octopusdeploy/api-client";
+import { z } from "zod";
+import {} from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getClientConfigurationFromEnvironment } from "../helpers/getClientConfigurationFromEnvironment.js";
+import { registerToolDefinition } from "../types/toolConfig.js";
+export function registerGetKubernetesLiveStatusTool(server) {
+    server.tool("get_kubernetes_live_status", `Get Kubernetes live status for a project and environment
+  
+  This tool retrieves the live status of Kubernetes resources for a specific project and environment. Optionally include a tenant ID for multi-tenant deployments.`, {
+        spaceName: z.string().describe("The space name"),
+        projectId: z.string().describe("The ID of the project"),
+        environmentId: z.string().describe("The ID of the environment"),
+        tenantId: z.string().optional().describe("The ID of the tenant (for multi-tenant deployments)"),
+        summaryOnly: z.boolean().optional().describe("Return summary information only")
+    }, {
+        title: "Get Kubernetes live status from Octopus Deploy",
+        readOnlyHint: true,
+    }, async ({ spaceName, projectId, environmentId, tenantId, summaryOnly = false }) => {
+        const configuration = getClientConfigurationFromEnvironment();
+        const client = await Client.create(configuration);
+        const observabilityRepository = new ObservabilityRepository(client, spaceName);
+        const liveStatus = await observabilityRepository.getLiveStatus(projectId, environmentId, tenantId, summaryOnly);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        projectId,
+                        environmentId,
+                        tenantId,
+                        summaryOnly: summaryOnly,
+                        liveStatus: {
+                            machineStatuses: liveStatus.MachineStatuses?.map((machine) => ({
+                                machineId: machine.MachineId,
+                                status: machine.Status,
+                                resources: machine.Resources?.map((resource) => ({
+                                    name: resource.Name,
+                                    namespace: resource.Namespace,
+                                    kind: resource.Kind,
+                                    healthStatus: resource.HealthStatus,
+                                    syncStatus: resource.SyncStatus,
+                                    machineId: resource.MachineId,
+                                    children: resource.Children,
+                                    desiredResourceId: resource.DesiredResourceId,
+                                    resourceId: resource.ResourceId
+                                }))
+                            })),
+                            summary: liveStatus.Summary ? {
+                                status: liveStatus.Summary.Status,
+                                lastUpdated: liveStatus.Summary.LastUpdated
+                            } : undefined
+                        }
+                    }),
+                },
+            ],
+        };
+    });
+}
+registerToolDefinition({
+    toolName: "get_kubernetes_live_status",
+    config: { toolset: "kubernetes", readOnly: true },
+    registerFn: registerGetKubernetesLiveStatusTool
+});
+//# sourceMappingURL=getKubernetesLiveStatus.js.map

package/dist/tools/getKubernetesLiveStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getKubernetesLiveStatus.js","sourceRoot":"","sources":["../../src/tools/getKubernetesLiveStatus.ts"],"names":[],"mappings":"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"}

package/dist/tools/getLatestDeployment.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetLatestDeploymentTool(server: McpServer): void;
+//# sourceMappingURL=getLatestDeployment.d.ts.map

package/dist/tools/getLatestDeployment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLatestDeployment.d.ts","sourceRoot":"","sources":["../../src/tools/getLatestDeployment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,QAqFhE"}