Octopus Deploy MCP Server

A Model Context Protocol (MCP) server for interacting with Octopus Deploy. This server provides tools for managing projects, releases, and deployments through the MCP protocol.

Features

Project Management: List and query Octopus Deploy projects
Release Management: Get latest releases and create new releases
Deployment Management: Deploy releases and check deployment status
Multi-Space Support: Work with different Octopus Deploy spaces
Docker Support: Containerized deployment for easy integration

Installation

1. Clone the Repository

git clone https://github.com/armanzeroeight/octopus-deploy-mcp-server.git
cd octopus-deploy-mcp

2. Build Docker Image

./scripts/build.sh

This will create a Docker image tagged as octopus-deploy-mcp:latest.

MCP Configuration

Add the following configuration to your MCP client's mcp.json file:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "octopus-api-key",
      "description": "Octopus Deploy API key",
      "password": true
    }
  ],
  "servers": {
    "octopus-deploy-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "OCTOPUS_URL",
        "-e",
        "OCTOPUS_API_KEY",
        "octopus-deploy-mcp:latest",
        "octopus-deploy-mcp"
      ],
      "env": {
        "OCTOPUS_URL": "https://your-octopus-server.com",
        "OCTOPUS_API_KEY": "${input:octopus-api-key}"
      }
    }
  }
}

Configuration Notes

Replace https://your-octopus-server.com with your actual Octopus Deploy server URL (without /api suffix)
The API key will be prompted securely when the MCP client starts
The Docker image must be built locally using the build script

Available Tools

Project Tools

list_projects: List all projects in a space
get_project_details: Get detailed information about a specific project

Release Tools

get_latest_release: Get the latest release for a project
create_release: Create a new release for a project

Deployment Tools

deploy_release: Deploy a release to an environment
check_deployment_status: Check the status of deployments

Development

Local Setup (without Docker)

# Install UV if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv sync

# Set up environment variables
cp .env.sh.example .env.sh
# Edit .env.sh with your Octopus Deploy credentials

# Run the server directly
source .env.sh

# Install the package in editable mode
uv pip install -e .
uv run octopus-deploy-mcp

# Or use fastmcp-cli tool for development
fastmcp dev dev.py

Testing Docker Build

# Test the Docker image locally
./scripts/test-docker.sh

Requirements

Docker
Your Octopus Deploy server URL
Valid Octopus Deploy API key with appropriate permissions

Troubleshooting

Common Issues

"Space 'Default' not found"
- Verify your Octopus server URL is correct
- Check that your API key has access to the specified space
- Ensure the space name exists (case-sensitive)
"Authentication failed"
- Verify your API key is correct and hasn't expired
- Check that the API key has the necessary permissions
Docker build fails
- Ensure Docker is running
- Check that you have sufficient disk space
- Verify internet connectivity for downloading dependencies

Debug Mode

The server automatically enables debug logging. Check the MCP client logs for detailed error information.

Support

For issues and questions, please create an issue on GitHub.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A server that enables interaction with Octopus Deploy through the Model Context Protocol, allowing users to manage projects, releases, and deployments across different spaces.

Related MCP Servers

Columbia MCP Server
GitDakky
-
security
F
license
-
quality
Facilitates deployment and management of services using the Model Context Protocol with a focus on high availability, scalability, and secure communication, leveraging Docker-based infrastructure, Prometheus, and Grafana for monitoring.
Last updated -
1
Columbia MCP Server
smithery-ai
-
security
F
license
-
quality
Provides a scalable, containerized infrastructure for deploying and managing Model Context Protocol servers with monitoring, high availability, and secure configurations.
Last updated -
Context Manager MCP Server
docherty
-
security
A
license
-
quality
A server implementation of the Model Context Protocol (MCP) for managing development workflow with features like project management, task tracking, and QA review support.
Last updated -
3
JavaScript
AGPL 3.0
Xcode MCP Server
devyhan
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for Xcode-related operations, making it easier to work with iOS project management, building, testing, archiving, and deploying apps to both simulators and physical devices.
Last updated -
9
669
4
JavaScript
MIT License

View all related MCP servers

Octopus Deploy MCP Server