CloudStack

You are using a CloudStack MCP Server that lets AI agents interact with CloudStack infrastructure by translating MCP requests into CloudStack API calls. It supports both a remote-like HTTP-based streaming endpoint and a local stdio server that you run in Docker, enabling VM deployment, management, and other CloudStack operations from your MCP client.

How to use

You can connect your MCP client to either the HTTP streaming endpoint or the local stdio server, depending on your setup and tooling. The HTTP option exposes a live stream you can query for CloudStack actions, while the stdio option runs a local server that your MCP client communicates with through standard input and output.

How to install

Prerequisites you need on macOS: a package manager, Docker, and Go-task for managing tasks.

# 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

Additional information

Connection options are provided as MCP server configurations. You can choose the HTTP streaming endpoint or the local stdio server, depending on how you prefer to integrate with your MCP client.

Notes on usage with MCP clients

If you use a server-RPC style client, you can connect via the HTTP endpoint at the streaming URL or run the local Docker-based stdio server and connect through standard input/output. For the HTTP option, you will target the SSE endpoint. For the stdio option, you will launch the Docker-based server and connect your client to its I/O streams.

CloudMonkey Usage and tooling

CloudMonkey is containerized in this setup, and you can run basic CloudStack CLI commands to explore zones, service offerings, and credentials. If you encounter API cache issues, a sync operation can help refresh data. You can also retrieve credentials when needed to authenticate with CloudStack.

Available tools

cloudmonkey

CloudMonkey usage for interacting with CloudStack from the CLI. Includes basic commands to list zones, list service offerings, synchronize API cache, and retrieve credentials.

claude_desktop

Claude Desktop setup steps to integrate the MCP server with Claude Desktop for local agent conversations.