CloudStack MCP

by walteh

292 downloads Not rated yet Apache-2.0 license

GitHub

Other

About

proof of concept MCP server for apache cloudstack

Details

License: Apache-2.0 license

Explore

- Translates MCP protocol requests into CloudStack API calls
- Provides common operations like VM deployment and management
- Handles authentication and API interaction automatically
- Supports both SSE and stdio transports
- Includes a containerized CloudMonkey CLI for manual CloudStack commands

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name CloudStack MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

From the repository

brew install go-task go docker git clone https://github.com/walteh/cloudstack-mcp.git cd cloudstack-mcp

task docker:start

1. make sure server is running and you are in the root of the project (see above)

2. set up dependencies

brew install --cask cursor

3. open the project in Cursor

cursor cloudstack-mcp.code-workspace

4. open cursor settings from the menu bar Cursor -> Settings... -> Cursor Settings (or press Shift-Cmd-J)

5. go to the MCP tab, you should see the cloudstack server already added (because of ./.cursor/mcp.json)

6. click on the buttons to refresh and enable the cloudstack server - you should see a green dot and a list of list cloudstack api commands

7. open a new composer by making sure the composer pane is open (toggle with Cmd-Option-B) and start a new conversation (press Cmd-N)

8. make sure the composer is set to Agent

9. type can you list my @cloudstack vpcs?

10. press Enter and watch the magic happen!

> [!CAUTION] > There is a 99% chance this will not work, but you can use it as a starting point to get the MCP working with Claude Desktop if you like. 1. make sure server is running and you are in the root of the project (see above) 2. set up dependencies

bash
brew install --cask claude-desktop

3. run this to setup the server in Claude Desktop

bash

task mcp:setup:claude-desktop

4. restart claude desktop CloudMonkey (the CloudStack CLI) is containerized in this setup:

bash

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cloudstack mcp": {
            "cloudstack": {
                "type": "http",
                "url": "http://localhost:8250/sse"
            }
        }
    }
}

McpServers

{
    "cloudstack": {
        "type": "http",
        "url": "http://localhost:8250/sse"
    }
}

A Model Context Protocol (MCP) server for Apache CloudStack, allowing AI agents to interact with CloudStack infrastructure.

> [!IMPORTANT]
> This project is still under development and not all features are available. Treat it as a proof of concept.

Running the server (macOS)

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Running the server (macOS)

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive