Skip to main content
Glama

Octopus Deploy MCP Server

by armanzeroeight
GitHub
Python
MIT License
6
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

  1. "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)

  2. "Authentication failed"

    • Verify your API key is correct and hasn't expired

    • Check that the API key has the necessary permissions

  3. 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
A
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.

  1. Features
    1. Installation
      1. 1. Clone the Repository
      2. 2. Build Docker Image
    2. MCP Configuration
      1. Configuration Notes
    3. Available Tools
      1. Project Tools
      2. Release Tools
      3. Deployment Tools
    4. Development
      1. Local Setup (without Docker)
      2. Testing Docker Build
    5. Requirements
      1. Troubleshooting
        1. Common Issues
        2. Debug Mode
      2. Support

        Related MCP Servers

        • Columbia MCP Server

          -
          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.

        • 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
          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
          23
          6
          MIT License
          • Apple

        View all related MCP servers

        New MCP Servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/armanzeroeight/octopus-deploy-mcp-server'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server