@octopusdeploy/mcp-server 1.0.1 → 1.1.0

package/README.md

@@ -70,6 +70,8 @@ We are planning to release a native ARM build shortly so that those arguments wi
 #### Configuration
 
 Full example configuration (for Claude Desktop, Claude Code, and Cursor):
+
+**Read-only mode (default, recommended for production):**
 ```json
 {
   "mcpServers": {
@@ -82,6 +84,19 @@ Full example configuration (for Claude Desktop, Claude Code, and Cursor):
 }
 ```
 
+**Write mode enabled (for development/testing):**
+```json
+{
+  "mcpServers": {
+    "octopusdeploy": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@octopusdeploy/mcp-server", "--api-key", "YOUR_API_KEY", "--server-url", "https://your-octopus.com", "--no-read-only"]
+    }
+  }
+}
+```
+
 The Octopus MCP Server is typically configured within your AI Client of choice. 
 
 It is packaged as an npm package and executed via Node's `npx` command. Your configuration will include the command invocation `npx`, and a set of arguments that supply the Octopus MCP Server package and provide the Octopus Server URL and API key required, if they are not available as environment variables.
@@ -136,24 +151,35 @@ Available toolsets:
 - **accounts** - Account operations
 
 #### Read-Only Mode
-The server runs in read-only mode by default for security. All current tools are read-only operations.
+The server runs in read-only mode by default for security. Most tools are read-only operations, but some tools can perform write operations (like creating releases and deployments).
+
+**Write-enabled tools:**
+- `create_release` - Create new releases
+- `deploy_release` - Deploy releases to environments and tenants
+
+To use write-enabled tools, you must explicitly disable read-only mode:
 
 ```bash
-# Run in read-only mode (default)
-npx -y @octopusdeploy/mcp-server --read-only
+# Run in read-only mode (default) - write tools are disabled
+npx -y @octopusdeploy/mcp-server
 
-# Disable read-only mode (currently no effect as all tools are read-only)
-npx -y @octopusdeploy/mcp-server --read-only=false
+# Disable read-only mode to enable write operations
+npx -y @octopusdeploy/mcp-server --no-read-only
 ```
 
+**Security Note:** When disabling read-only mode, ensure you use an API key with appropriate, least-privilege permissions. Write operations can create releases and trigger deployments in your Octopus instance.
+
 #### Complete Examples
 
 ```bash
 # Development setup with only core and project tools
 npx -y @octopusdeploy/mcp-server --toolsets core,projects --server-url https://your-octopus.com --api-key YOUR_API_KEY
 
-# Full production setup with all tools
-npx -y @octopusdeploy/mcp-server --toolsets all --read-only --server-url https://your-octopus.com --api-key YOUR_API_KEY
+# Full production setup with all tools (read-only by default)
+npx -y @octopusdeploy/mcp-server --toolsets all --server-url https://your-octopus.com --api-key YOUR_API_KEY
+
+# Development setup with write operations enabled
+npx -y @octopusdeploy/mcp-server --no-read-only --server-url https://your-octopus.com --api-key YOUR_API_KEY
 ```
 
 #### Other command line arguments
@@ -173,11 +199,12 @@ npx -y @octopusdeploy/mcp-server --toolsets all --read-only --server-url https:/
 - `list_projects`: List all projects in a given space
 
 ### Deployments
+- `deploy_release`: Deploy a release to environments (supports both tenanted and untenanted deployments)
 - `list_deployments`: List deployments in a space with optional filtering
 
 ### Releases
-- `get_release_by_id`: Get details for a specific release by its ID
-- `list_releases`: List all releases in a given space
+- `create_release`: Create a new release for a project
+- `find_releases`: Find releases in a space (can get a specific release by ID or list all releases)
 - `list_releases_for_project`: List all releases for a specific project
 
 ### Tasks
@@ -186,8 +213,7 @@ npx -y @octopusdeploy/mcp-server --toolsets all --read-only --server-url https:/
 - `get_task_raw`: Get raw details for a specific server task
 
 ### Tenants
-- `list_tenants`: List all tenants in a given space
-- `get_tenant_by_id`: Get details for a specific tenant by its ID
+- `find_tenants`: Find tenants in a space (can get a specific tenant by ID or list/search tenants with filters)
 - `get_tenant_variables`: Get tenant variables by type (all, common, or project)
 - `get_missing_tenant_variables`: Get tenant variables that are missing values
 
@@ -195,16 +221,13 @@ npx -y @octopusdeploy/mcp-server --toolsets all --read-only --server-url https:/
 - `get_kubernetes_live_status`: Get live status of Kubernetes resources for a project and environment (minimum supported version: `2025.3`)
 
 ### Machines (Deployment Targets)
-- `list_deployment_targets`: List all deployment targets in a space with optional filtering
-- `get_deployment_target`: Get detailed information about a specific deployment target
+- `find_deployment_targets`: Find deployment targets in a space (can get a specific target by ID or list/search targets with filters)
 
 ### Certificates
-- `list_certificates`: List all certificates in a space with optional filtering
-- `get_certificate`: Get detailed information about a specific certificate by its ID
+- `find_certificates`: Find certificates in a space (can get a specific certificate by ID or list/search certificates with filters)
 
 ### Accounts
-- `list_accounts`: List all accounts in a space with optional filtering
-- `get_accounts`: Get detailed information about a specific account by its ID
+- `find_accounts`: Find accounts in a space (can get a specific account by ID or list/search accounts with filters)
 
 ### Additional Tools
 - `get_deployment_process`: Get deployment process by ID for projects or releases
@@ -213,11 +236,24 @@ npx -y @octopusdeploy/mcp-server --toolsets all --read-only --server-url https:/
 
 ## 🔒 Security Considerations
 
-While the Octopus MCP Server at this stage is a read-only tool, it **can read full deployment logs, which could include production secrets.** Exercise caution when connecting Octopus MCP to tools and models you do not fully trust.
+The Octopus MCP Server includes both read and write operations. Important security considerations:
+
+### Read Operations
+- Can read full deployment logs, which could include production secrets if they were not marked as secrets
+- Access to sensitive configuration data and variables
+- Exercise caution when connecting to tools and models you do not fully trust
+
+### Write Operations
+When read-only mode is disabled (`--no-read-only`), the following write operations are available:
+- **Creating releases**: Can create new releases for projects
+- **Deploying releases**: Can trigger deployments to environments (including production)
 
-Running agents in a fully automated fashion could make you vulnerable to exposure via prompt-injection attacks that exfiltrate tokens.
+**Critical Security Measures:**
+1. **Least Privilege**: Use API keys with the minimum permissions needed for your use case
+2. **Read-Only by Default**: The server defaults to read-only mode - you must explicitly opt-in to write operations
+3. **Prompt Injection Risk**: Running agents in fully automated fashion could make you vulnerable to prompt-injection attacks
 
-Exercise caution and mitigate the risks by using least-privileged accounts when connecting to Octopus Server.
+**Recommendation**: For production environments, use read-only mode unless you have a specific, controlled use case for write operations.
 
 ## ⚠️ Limitations
 

package/dist/helpers/errorHandling.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Enhanced error handling utilities for Octopus Deploy MCP Server tools
+ */
+/**
+ * Checks if the error is an Error instance and has a message containing the specified text
+ */
+export declare function isErrorWithMessage(error: unknown, messageFragment: string): error is Error;
+/**
+ * Common error handler for Octopus Deploy API errors with actionable messages
+ */
+export declare function handleOctopusApiError(error: unknown, context: {
+    entityType?: string;
+    entityId?: string;
+    spaceName?: string;
+    helpText?: string;
+}): never;
+/**
+ * Validates entity ID format with actionable error messages
+ */
+export declare function validateEntityId(id: string | undefined, entityType: string, prefix: string): void;
+/**
+ * Entity ID prefixes for common Octopus Deploy entities
+ */
+export declare const ENTITY_PREFIXES: {
+    readonly task: "ServerTasks-";
+    readonly project: "Projects-";
+    readonly environment: "Environments-";
+    readonly tenant: "Tenants-";
+    readonly release: "Releases-";
+    readonly machine: "Machines-";
+    readonly certificate: "Certificates-";
+    readonly account: "Accounts-";
+    readonly deploymentProcess: "DeploymentProcesses-";
+};
+//# sourceMappingURL=errorHandling.d.ts.map

package/dist/helpers/errorHandling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandling.d.ts","sourceRoot":"","sources":["../../src/helpers/errorHandling.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,MAAM,GACtB,KAAK,IAAI,KAAK,CAIhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,KAAK,CAmDP;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,IAAI,CAeN;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;CAUlB,CAAC"}

package/dist/helpers/errorHandling.js

@@ -0,0 +1,72 @@
+/**
+ * Enhanced error handling utilities for Octopus Deploy MCP Server tools
+ */
+/**
+ * Checks if the error is an Error instance and has a message containing the specified text
+ */
+export function isErrorWithMessage(error, messageFragment) {
+    return (error instanceof Error && error.message?.includes(messageFragment) === true);
+}
+/**
+ * Common error handler for Octopus Deploy API errors with actionable messages
+ */
+export function handleOctopusApiError(error, context) {
+    const { entityType, entityId, spaceName, helpText } = context;
+    // Handle 404/not found errors
+    if (isErrorWithMessage(error, "not found") ||
+        isErrorWithMessage(error, "404")) {
+        if (entityType && entityId && spaceName) {
+            throw new Error(`${entityType.charAt(0).toUpperCase() + entityType.slice(1)} '${entityId}' not found in space '${spaceName}'. ` +
+                (helpText ||
+                    `Verify the ${entityType} ID is correct using list_${entityType}s.`));
+        }
+        if (spaceName) {
+            throw new Error(`Space '${spaceName}' not found. Use list_spaces to see available spaces. Space names are case-sensitive.`);
+        }
+    }
+    // Handle authentication errors
+    if (isErrorWithMessage(error, "authentication") ||
+        isErrorWithMessage(error, "401") ||
+        isErrorWithMessage(error, "You must be logged in to request this resource") ||
+        isErrorWithMessage(error, "provide a valid API key")) {
+        throw new Error("Authentication failed. Ensure OCTOPUS_API_KEY environment variable is set with a valid API key. " +
+            "You can generate an API key from your Octopus Deploy user profile.");
+    }
+    // Handle connection errors
+    if (isErrorWithMessage(error, "connect") ||
+        isErrorWithMessage(error, "timeout")) {
+        throw new Error("Cannot connect to Octopus Deploy instance. Check that OCTOPUS_SERVER_URL environment variable is set correctly " +
+            "(e.g., 'https://your-instance.octopus.app') and that the instance is accessible.");
+    }
+    // Re-throw the original error if no specific handling applies
+    throw error;
+}
+/**
+ * Validates entity ID format with actionable error messages
+ */
+export function validateEntityId(id, entityType, prefix) {
+    if (!id) {
+        // This shouldn't happen due to Zod validation, but kept for safety
+        throw new Error(`${entityType.charAt(0).toUpperCase() + entityType.slice(1)} ID is required. ` +
+            `Use list_${entityType}s to find ${entityType} IDs.`);
+    }
+    if (!id.startsWith(prefix)) {
+        throw new Error(`Invalid ${entityType} ID format '${id}'. ${entityType.charAt(0).toUpperCase() + entityType.slice(1)} IDs should start with '${prefix}' followed by numbers. ` +
+            `Use list_${entityType}s to find valid ${entityType} IDs.`);
+    }
+}
+/**
+ * Entity ID prefixes for common Octopus Deploy entities
+ */
+export const ENTITY_PREFIXES = {
+    task: "ServerTasks-",
+    project: "Projects-",
+    environment: "Environments-",
+    tenant: "Tenants-",
+    release: "Releases-",
+    machine: "Machines-",
+    certificate: "Certificates-",
+    account: "Accounts-",
+    deploymentProcess: "DeploymentProcesses-",
+};
+//# sourceMappingURL=errorHandling.js.map

package/dist/helpers/errorHandling.js.map

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

package/dist/helpers/getClientConfigurationFromEnvironment.js

@@ -1,6 +1,6 @@
 import {} from "@octopusdeploy/api-client";
 import { env } from "process";
-import { SEMVER_VERSION } from "../index.js";
+import { SEMVER_VERSION } from "../utils/version.js";
 import { getClientInfo } from "../utils/clientInfo.js";
 const USER_AGENT_NAME = "octopus-mcp-server";
 function isEmpty(value) {

package/dist/helpers/getClientConfigurationFromEnvironment.js.map

@@ -1 +1 @@
-{"version":3,"file":"getClientConfigurationFromEnvironment.js","sourceRoot":"","sources":["../../src/helpers/getClientConfigurationFromEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAO7C,SAAS,OAAO,CAAC,KAAyB;IACxC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,GAAG,eAAe,IAAI,cAAc,KAAK,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,OAAO,GAAG,CAAC;IAEpG,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,sBAAsB,CAAC,UAAgC,EAAE;IAChE,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,6KAA6K,CAC9K,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IAEvC,OAAO;QACL,YAAY,EAAE,SAAS;QACvB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC;IACnD,OAAO,sBAAsB,CAAC;QAC5B,WAAW,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,oBAAoB,CAAC;QAC/D,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,CAAC;KACrD,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"getClientConfigurationFromEnvironment.js","sourceRoot":"","sources":["../../src/helpers/getClientConfigurationFromEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAO7C,SAAS,OAAO,CAAC,KAAyB;IACxC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,GAAG,eAAe,IAAI,cAAc,KAAK,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,OAAO,GAAG,CAAC;IAEpG,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,sBAAsB,CAAC,UAAgC,EAAE;IAChE,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,6KAA6K,CAC9K,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IAEvC,OAAO;QACL,YAAY,EAAE,SAAS;QACvB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC;IACnD,OAAO,sBAAsB,CAAC;QAC5B,WAAW,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,oBAAoB,CAAC;QAC/D,MAAM,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,CAAC;KACrD,CAAC,CAAC;AACL,CAAC"}

package/dist/helpers/spaceResolver.d.ts

@@ -0,0 +1,4 @@
+import { Client } from "@octopusdeploy/api-client";
+export declare function resolveSpaceNameFromId(client: Client, spaceId: string): Promise<string>;
+export declare function clearSpaceCache(): void;
+//# sourceMappingURL=spaceResolver.d.ts.map

package/dist/helpers/spaceResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaceResolver.d.ts","sourceRoot":"","sources":["../../src/helpers/spaceResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAmB,MAAM,2BAA2B,CAAC;AAKpE,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/helpers/spaceResolver.js

@@ -0,0 +1,18 @@
+import { Client, SpaceRepository } from "@octopusdeploy/api-client";
+const spaceCache = new Map();
+const CACHE_TTL = 3600000; // 1 hour in milliseconds
+export async function resolveSpaceNameFromId(client, spaceId) {
+    const cached = spaceCache.get(spaceId);
+    const now = Date.now();
+    if (cached && now - cached.timestamp < CACHE_TTL) {
+        return cached.name;
+    }
+    const spaceRepository = new SpaceRepository(client);
+    const space = await spaceRepository.get(spaceId);
+    spaceCache.set(spaceId, { name: space.Name, timestamp: now });
+    return space.Name;
+}
+export function clearSpaceCache() {
+    spaceCache.clear();
+}
+//# sourceMappingURL=spaceResolver.js.map

package/dist/helpers/spaceResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaceResolver.js","sourceRoot":"","sources":["../../src/helpers/spaceResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,UAAU,GAAG,IAAI,GAAG,EAA+C,CAAC;AAC1E,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,yBAAyB;AAEpD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAc,EACd,OAAe;IAEf,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,GAAG,SAAS,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAEjD,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAE9D,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,UAAU,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC"}

package/dist/helpers/urlParser.d.ts

@@ -0,0 +1,16 @@
+export interface OctopusUrlParts {
+    serverUrl: string;
+    spaceId?: string;
+    resourceType?: "deployment" | "release" | "project" | "tenant" | "task" | "unknown";
+    resourceId?: string;
+    projectSlug?: string;
+    releaseVersion?: string;
+}
+export declare function parseOctopusUrl(url: string): OctopusUrlParts;
+export declare function extractDeploymentId(url: string): string | null;
+export declare function extractTaskId(url: string): string | null;
+export declare function extractSpaceId(url: string): string | null;
+export declare function extractProjectSlug(url: string): string | null;
+export declare function extractReleaseVersion(url: string): string | null;
+export declare function extractTenantId(url: string): string | null;
+//# sourceMappingURL=urlParser.d.ts.map

package/dist/helpers/urlParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlParser.d.ts","sourceRoot":"","sources":["../../src/helpers/urlParser.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAwD5D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG7D;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1D"}

package/dist/helpers/urlParser.js

@@ -0,0 +1,83 @@
+export function parseOctopusUrl(url) {
+    try {
+        const urlObj = new URL(url);
+        const serverUrl = `${urlObj.protocol}//${urlObj.host}`;
+        const hashPath = urlObj.hash.startsWith("#/") ? urlObj.hash.substring(2) : urlObj.hash.substring(1);
+        const pathParts = hashPath.split("/").filter(Boolean);
+        const result = {
+            serverUrl,
+        };
+        const spaceId = extractSpaceId(url);
+        if (spaceId) {
+            result.spaceId = spaceId;
+        }
+        if (pathParts.includes("deployments")) {
+            const deploymentId = extractDeploymentId(url);
+            if (deploymentId) {
+                result.resourceType = "deployment";
+                result.resourceId = deploymentId;
+            }
+            else {
+                const releaseVersion = extractReleaseVersion(url);
+                if (releaseVersion) {
+                    result.resourceType = "release";
+                    result.resourceId = releaseVersion;
+                    result.releaseVersion = releaseVersion;
+                }
+            }
+        }
+        else if (pathParts.includes("tasks")) {
+            const taskId = extractTaskId(url);
+            if (taskId) {
+                result.resourceType = "task";
+                result.resourceId = taskId;
+            }
+        }
+        else if (pathParts.includes("projects")) {
+            result.resourceType = "project";
+            const projectSlug = extractProjectSlug(url);
+            if (projectSlug) {
+                result.projectSlug = projectSlug;
+            }
+        }
+        else if (pathParts.includes("tenants")) {
+            const tenantId = extractTenantId(url);
+            if (tenantId) {
+                result.resourceType = "tenant";
+                result.resourceId = tenantId;
+            }
+        }
+        else {
+            result.resourceType = "unknown";
+        }
+        return result;
+    }
+    catch (error) {
+        throw new Error(`Failed to parse Octopus URL: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export function extractDeploymentId(url) {
+    const match = url.match(/\/deployments\/(Deployments-\d+)/);
+    return match ? match[1] : null;
+}
+export function extractTaskId(url) {
+    const match = url.match(/\/tasks\/(ServerTasks-\d+)/);
+    return match ? match[1] : null;
+}
+export function extractSpaceId(url) {
+    const match = url.match(/\/(Spaces-\d+)/);
+    return match ? match[1] : null;
+}
+export function extractProjectSlug(url) {
+    const match = url.match(/\/projects\/([^/]+)/);
+    return match ? match[1] : null;
+}
+export function extractReleaseVersion(url) {
+    const match = url.match(/\/releases\/([^/]+)/);
+    return match ? match[1] : null;
+}
+export function extractTenantId(url) {
+    const match = url.match(/\/tenants\/(Tenants-\d+)/);
+    return match ? match[1] : null;
+}
+//# sourceMappingURL=urlParser.js.map

package/dist/helpers/urlParser.js.map

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -5,13 +5,13 @@ import { registerTools } from "./tools/index.js";
 import { Command } from "commander";
 import dotenv from "dotenv";
 import { createToolsetConfig } from "./utils/parseConfig.js";
-import { DEFAULT_TOOLSETS, printToolVersionAnalysis } from "./types/toolConfig.js";
+import { DEFAULT_TOOLSETS, printToolVersionAnalysis, } 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" };
 import { fileURLToPath } from "url";
-import { dirname, join, isAbsolute } from "path";
+import { dirname, join } from "path";
 export const SEMVER_VERSION = packageJson.version;
 // Set entry directory for logger (ESM equivalent of __dirname)
 const __filename = fileURLToPath(import.meta.url);
@@ -26,9 +26,9 @@ program
     .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("--no-read-only", "Disable read-only mode to enable write operations (default: read-only enabled)")
     .option("--log-level <level>", "Minimum log level (info, error)", "info")
-    .option("--log-file <path>", 'Log file path or filename. If not specified, logs are written to console only.')
+    .option("--log-file <path>", "Log file path or filename. If not specified, logs are written to console only.")
     .option("-q, --quiet", "Disable file logging, only log errors to console", false)
     .option("--list-tools-by-version", "List all registered tools by their supported Octopus Server version and exit")
     .parse();
@@ -45,7 +45,7 @@ if (options.listToolsByVersion) {
     process.exit(0);
 }
 if (options.logFile) {
-    if (dirname(options.logFile) === '.') {
+    if (dirname(options.logFile) === ".") {
         logger.setLogFilePath(join(__dirname, options.logFile));
     }
     else {
@@ -60,8 +60,6 @@ if (options.serverUrl) {
 if (options.apiKey) {
     process.env.CLI_API_KEY = options.apiKey;
 }
-// Test configuration
-getClientConfigurationFromEnvironment();
 // Set up initialization callback to capture client info
 server.server.oninitialized = () => {
     const clientInfo = server.server.getClientVersion();
@@ -76,6 +74,8 @@ server.server.oninitialized = () => {
 logger.info(`Starting Octopus Deploy MCP server (version: ${SEMVER_VERSION})`);
 // Start server
 async function runServer() {
+    // Test configuration
+    getClientConfigurationFromEnvironment();
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/dist/index.js.map

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

package/dist/tools/createRelease.d.ts

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

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

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

package/dist/tools/createRelease.js

@@ -0,0 +1,108 @@
+import { Client, ReleaseRepository } 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";
+import { handleOctopusApiError } from "../helpers/errorHandling.js";
+export function registerCreateReleaseTool(server) {
+    server.tool("create_release", `Create a new release for an Octopus Deploy project
+
+This tool creates a new release for a project. The space name and project name are required. All other parameters are optional and will use Octopus defaults if not specified.`, {
+        spaceName: z.string().describe("The space name"),
+        projectName: z.string().describe("The project name"),
+        releaseVersion: z
+            .string()
+            .optional()
+            .describe("The version for the release (e.g., '1.0.0'). If not specified, Octopus will auto-generate based on project settings."),
+        channelName: z
+            .string()
+            .optional()
+            .describe("The channel name (uses default channel if not specified)"),
+        packageVersion: z
+            .string()
+            .optional()
+            .describe("Default package version to use for all packages"),
+        packages: z
+            .array(z.string())
+            .optional()
+            .describe("Array of package specifications (format depends on Octopus configuration)"),
+        gitCommit: z.string().optional().describe("Git commit hash"),
+        gitRef: z.string().optional().describe("Git reference (branch or tag)"),
+        releaseNotes: z
+            .string()
+            .optional()
+            .describe("Release notes for this release"),
+        ignoreIfAlreadyExists: z
+            .boolean()
+            .optional()
+            .describe("If true, skip creation if release already exists (returns existing release)"),
+        ignoreChannelRules: z
+            .boolean()
+            .optional()
+            .describe("If true, ignore channel version rules"),
+        packagePrerelease: z
+            .string()
+            .optional()
+            .describe("Package prerelease tag"),
+        customFields: z
+            .record(z.string())
+            .optional()
+            .describe("Custom field values as key-value pairs"),
+    }, {
+        title: "Create a new release in Octopus Deploy",
+        readOnlyHint: false,
+    }, async ({ spaceName, projectName, releaseVersion, channelName, packageVersion, packages, gitCommit, gitRef, releaseNotes, ignoreIfAlreadyExists, ignoreChannelRules, packagePrerelease, customFields, }) => {
+        try {
+            const configuration = getClientConfigurationFromEnvironment();
+            const client = await Client.create(configuration);
+            const releaseRepository = new ReleaseRepository(client, spaceName);
+            const command = {
+                spaceName: spaceName,
+                ProjectName: projectName,
+                ...(releaseVersion && { ReleaseVersion: releaseVersion }),
+                ...(channelName && { ChannelName: channelName }),
+                ...(packageVersion && { PackageVersion: packageVersion }),
+                ...(packages && { Packages: packages }),
+                ...(gitCommit && { GitCommit: gitCommit }),
+                ...(gitRef && { GitRef: gitRef }),
+                ...(releaseNotes && { ReleaseNotes: releaseNotes }),
+                ...(ignoreIfAlreadyExists !== undefined && {
+                    IgnoreIfAlreadyExists: ignoreIfAlreadyExists,
+                }),
+                ...(ignoreChannelRules !== undefined && {
+                    IgnoreChannelRules: ignoreChannelRules,
+                }),
+                ...(packagePrerelease && { PackagePrerelease: packagePrerelease }),
+                ...(customFields && { CustomFields: customFields }),
+            };
+            const response = await releaseRepository.create(command);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            releaseId: response.ReleaseId,
+                            releaseVersion: response.ReleaseVersion,
+                            message: `Release ${response.ReleaseVersion} created successfully`,
+                            helpText: "Use find_releases to view release details, or use deploy_release to deploy this release to environments.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            handleOctopusApiError(error, {
+                entityType: "release",
+                spaceName,
+                helpText: "Use list_projects to find valid project names. Ensure you have permissions to create releases and that the project exists.",
+            });
+        }
+    });
+}
+registerToolDefinition({
+    toolName: "create_release",
+    config: { toolset: "releases", readOnly: false },
+    registerFn: registerCreateReleaseTool,
+});
+//# sourceMappingURL=createRelease.js.map

package/dist/tools/createRelease.js.map

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