Octopus Deploy Official Mcp Server

Name: Octopus Deploy Official Mcp Server
Author: OctopusDeploy

@OctopusDeploy

关于 Octopus Deploy Official Mcp Server

The Octopus MCP Server provides your AI assistant with powerful tools that allow it to inspect, query, and diagnose problems within your Octopus instance, transforming it into your ultimate DevOps wingmate.

#octopus-deploy #devops #mcp-server

基本信息

分类

其他

传输方式

stdio

发布者

OctopusDeploy

提交者

Egor Pavlikhin

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "octopusdeploy": {
      "command": "npx",
      "args": [
        "-y",
        "@octopusdeploy/mcp-server",
        "--api-key",
        "YOUR_API_KEY",
        "--server-url",
        "https://your-octopus.com"
      ]
    }
  }
}

工具

List all spaces in the Octopus Deploy instance. Spaces is the main organizational unit in Octopus Deploy, Spaces keep the different projects, infrastructure and tenants completely separate. Spaces typically represent team or project boundary, but not customer boundary (use tenants for those). Always use this tool first to check that the requested space exists.

This tool lists all projects in a given space. Projects let you manage software applications and services, each with their own deployment process, lifecycles, and variables. Projects are where you define what you are deploying and how it should be deployed. The space name is required, if you can't find the space name, ask the user directly for the name of the space. Optionally filter by partial name match using partialName parameter.

List environments in a space This tool lists all environments in a given space. The space name is required. Use this tool as early as possible to understand which environments are configured. Optionally filter by partial name match using partialName parameter.

List deployments in a space This tool lists deployments in a given space. The space name is required. When requesting latest deployment consider which deployment state the user is interested in (successful or all). Optional filters include: projects (array of project IDs), environments (array of environment IDs), tenants (array of tenant IDs), channels (array of channel IDs), taskState (one of: Canceled, Cancelling, Executing, Failed, Queued, Success, TimedOut), and take (number of results to return).

Get details for a specific release by its ID

List releases in a space This tool lists all releases in a given space. The space name is required. Optionally provide skip and take parameters for pagination.

List releases for a specific project This tool lists all releases for a given project in a space. The space name and project ID are required. Optionally provide skip, take, and searchByVersion parameters.

Get details for a specific server task by its ID. Tasks represent background operations in Octopus Deploy, such as deployments, health checks, and system maintenance. Each task has a unique ID and can be monitored for status and progress.

Get detailed information for a specific server task by its ID. Tasks represent background operations in Octopus Deploy, such as deployments, health checks, and system maintenance. Each task has a unique ID and can be monitored for status and progress.

Get raw details for a specific server task by its ID

List tenants in a space This tool lists all tenants in a given space. The space name is required. Optionally provide skip and take parameters for pagination.

Get details for a specific tenant by its ID. Tenants represent customers or clients in Octopus Deploy, allowing you to manage deployments and configurations specific to each tenant. Tenants can be grouped into tenant tags for easier management and deployment targeting. Tenants can also represent geographical locations, organizational units, or any other logical grouping.

Get tenant variables by type This tool retrieves different types of tenant variables. Use variableType parameter to specify which type: - "all": Get all tenant variables - "common": Get common variables only - "project": Get project-specific variables only

Get missing tenant variables This tool retrieves tenant variables that are missing values. Optionally filter by tenant, project, or environment.

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.

List deployment targets (machines) in a space This tool lists all deployment targets in a given space. The space name is required. You can optionally filter by various parameters like name, roles, health status, etc.

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.

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.

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.

Get information about the current authenticated user This tool retrieves information about the currently authenticated user from the Octopus Deploy API.

List certificates in a space This tool lists all certificates in a given space. The space name is required. You can optionally filter by various parameters like name, archived status, tenant, etc.

Get details for a specific certificate by its ID This tool retrieves detailed information about a specific certificate using its ID. The space name and certificate ID are both required.

List accounts in a space This tool lists all accounts in a given space. The space name is required. You can optionally filter by various parameters like name, account type, etc.

Get details for a specific account by its ID This tool retrieves detailed information about a specific account using its ID. The space name and account ID are both required.

This tool gets all project and library variable set variables for a given project. Projects can contain variables (specific to a project), library variable sets (shared collections of variables associated with many projects), and tenant variables (variables related to a tenants connected to the project) If you want to retrieve tenant variables for a tenant connected to the project, use the get_tenant_variables tool.

概览

What is Octopus Deploy Official MCP Server?

The Octopus Deploy Official MCP Server connects AI assistants (such as Claude Code or ChatGPT) to an Octopus Deploy instance via the Model Context Protocol. It provides tools to inspect, query, and diagnose problems within the Octopus instance, acting as a DevOps assistant. This server is intended for users of Octopus Deploy who want AI-driven interaction with their deployment, release, and operations workflows.

How to use Octopus Deploy Official MCP Server?

Installation requires Node.js >= v20.0.0, an Octopus Deploy instance accessible via HTTPS, and an API Key. Configure the server in your AI client (e.g., Claude Desktop, Claude Code, Cursor) using the npx command with arguments --api-key and --server-url, or by setting the OCTOPUS_API_KEY and OCTOPUS_SERVER_URL environment variables.

Key features of Octopus Deploy Official MCP Server

Inspect Octopus instance resources and status.
Query deployments, releases, and other data.
Diagnose problems within Octopus deployments.
Uses stable APIs from Octopus Server 2021.1+.
Command‑line argument to list tools by version.
Early Access (subject to breaking changes).

Use cases of Octopus Deploy Official MCP Server

Inspecting Octopus instance configuration and health.
Querying release and deployment history for specific projects.
Diagnosing failed deployments or operational issues.
Checking environment status and machine policies.

FAQ from Octopus Deploy Official MCP Server

What are the system requirements?

Node.js >= v20.0.0, an Octopus Deploy instance accessible via HTTPS, and a valid Octopus Deploy API Key.

Which Octopus Server versions are compatible?

Most tools use APIs available from Octopus Server 2021.1. Newer tools may require a later version; the --list-tools-by-version argument shows version relationships.

How is the server configured?

Configuration is done in your AI client using the npx command with --server-url and --api-key arguments, or via the OCTOPUS_SERVER_URL and OCTOPUS_API_KEY environment variables.

Which AI clients are supported?

The README gives configuration examples for Claude Desktop, Claude Code, and Cursor.

Is the server stable?

The project is currently in Early Access and subject to breaking changes.

其他分类下的更多 MCP 服务器

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K