= CloudStack MCP

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)

[source,bash]

Install the dependencies

brew install go-task go docker

Install the CLI

git clone https://github.com/walteh/cloudstack-mcp.git cd cloudstack-mcp

Start the environment (will take a while)

task docker:start

== Generic MCP Usage

=== for sse servers (recommended, if possible)

• works with Cursor

[source,json]

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

=== for stdio servers

• works with Cursor, and Claude Desktop

[source,json]

{ "mcpServers": { "cloudstack": { "command": "docker", "args": ["compose", "-f", "<<LOCAL_PATH_TO_THIS_REPO>>/docker-compose.yaml", "run", "mcp-stdio-server"] } } }

== Usage with Cursor (macOS)

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

2. set up dependencies

[source,bash]

brew install --cask cursor

1. open the project in Cursor

[source,bash]

cursor cloudstack-mcp.code-workspace

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

2. go to the MCP tab, you should see the cloudstack server already added (because of link:./.cursor/mcp.json[./.cursor/mcp.json])

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

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

5. make sure the composer is set to Agent

6. type can you list my @cloudstack vpcs?

7. press Enter and watch the magic happen! (realistically, you might have to try and convince the AI to do this, but it should work)

== Usage with Claude Desktop (macOS)

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

[source,bash]

brew install --cask claude-desktop

1. run this to setup the server in Claude Desktop

[source,bash]

injects the server into claudes config, doesn't overwrite anything (unless you have another mcp called 'cloudstack')

task mcp:setup:claude-desktop

1. restart claude desktop

== How It Works

This MCP implementation allows AI assistants to manage CloudStack resources by:

• Translating MCP protocol requests into CloudStack API calls
• Providing common operations like VM deployment and management
• Handling authentication and API interaction automatically

== CloudMonkey Usage

CloudMonkey (the CloudStack CLI) is containerized in this setup:

[source,bash]

Basic commands

task cmk -- list zones task cmk -- list serviceofferings

Fix API cache issues if they occur

task cmk -- sync

Get API credentials

task cloudstack:get-credentials

== License

Apache License 2.0