upcloud

The Upcloud MCP Server provides a Model Context Protocol interface to interact with Upcloud services. It exposes tools for Account, Database, Server, and Kubernetes resources, enabling you to query and manage Upcloud resources via MCP commands such as get_account, get_database, get_servers, get_server_details, get_kubernetes_clusters, get_kubernetes_cluster, and get_kubernetes_plans. This server is designed to be run inside a container (Docker) and wired into your MCP client or Claude-like tooling so you can issue structured requests and receive responses from Upcloud APIs through the MCP layer. To use it, start the container with the required Upcloud credentials and point your MCP client at the server, then invoke the available tools with the appropriate parameters (e.g., account username, database UUID, server UUID).

Prerequisites:

• Docker installed and running on your host.
• Upcloud credentials (UPCLOUD_USERNAME and UPCLOUD_PASSWORD).

Installation steps:

1. Ensure Docker is installed and running on your machine.

2. Run the server container with the required environment variables:

   docker run -i --rm
   -e UPCLOUD_USERNAME=YOUR_USERNAME
   -e UPCLOUD_PASSWORD=YOUR_PASSWORD
   ghcr.io/marinx/upcloud-mcp-server

3. Configure your MCP client to connect to the running server as defined in the mcp_config. If you are using Claude Desktop or a similar tool, add the mcpServers entry (see mcp_config) to point to the docker-based server and supply the environment variables in the config as shown.

4. Verify connectivity by issuing a basic MCP request such as get_account to confirm that the server can communicate with Upcloud APIs.

Notes and tips:

• The server relies on environment variables UPCLOUD_USERNAME and UPCLOUD_PASSWORD; never hard-code credentials in code. Use your secrets manager or tool-specific secret handling where possible.
• The Docker command uses --rm to remove the container after use; omit if you want to keep the container state for debugging.
• Ensure network access from the host to Upcloud APIs is allowed and that any required firewall rules are configured.
• If you encounter authentication errors, double-check the provided credentials and ensure they have the necessary Upcloud API permissions.
• This repository indicates the server is a work in progress; validate against Upcloud API changes and monitor for updates or breaking changes when upgrading the image.