mcpField
U
Upcloud MCP Server

Upcloud MCP Server

Local
github.com/MarinXCloud & Infra2Updated 79w ago
Repository

About Upcloud MCP Server

Upcloud MCP Server is an unfinished MCP server for developers building tools that work with Upcloud APIs. Its listed tools retrieve account, database, server, and Kubernetes information; the project is not yet ready for use.

Key features

  1. 01Retrieve account information
  2. 02Look up managed databases by UUID
  3. 03List servers and retrieve server details
  4. 04List Kubernetes clusters and plans
  5. 05Retrieve Kubernetes cluster details

Use cases

  1. 01Extract and analyze data from Upcloud services
  2. 02Build AI-powered applications that interact with Upcloud

MCP support

It exposes Upcloud API operations as tools for MCP clients, including account, database, server, and Kubernetes queries. The README says the project is still in progress and not ready for use.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "upcloud": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UPCLOUD_USERNAME",
        "-e",
        "UPCLOUD_PASSWORD",
        "ghcr.io/marinx/upcloud-mcp-server"
      ],
      "env": {
        "UPCLOUD_USERNAME": "<UPCLOUD_USERNAME>",
        "UPCLOUD_PASSWORD": "<UPCLOUD_PASSWORD>"
      }
    }
  }
}
Run commanddocker run -i --rm -e UPCLOUD_USERNAME -e UPCLOUD_PASSWORD ghcr.io/marinx/upcloud-mcp-server
Environment variables to set
UPCLOUD_USERNAME
UPCLOUD_PASSWORDSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocighcr.io/marinx/upcloud-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Upcloud MCP Server

Work in progress!!!

This is a work in progress and not yet ready for any type of use. Please check back later for updates.

Overview

The Upcloud MCP Server is a Model Context Protocol (MCP) server that provides seamless integration with Upcloud APIs, enabling advanced automation and interaction capabilities for developers and tools. The idea comes from Github MCP server

Use Cases

  • Extracting and analyzing data from Upcloud services.
  • Building AI powered tools and applications that interact with Upcloud's ecosystem.

Prerequisites

  1. To run the server in a container, you will need to have Docker installed.
  2. Once Docker is installed, you will also need to ensure Docker is running.
  3. Lastly you will need to populate UPCLOUD_USERNAME and UPCLOUD_PASSWORD variables.

Installation

Local usage
go build cmd/upcloud-mcp-server

and move the binary to your bin location and move the claude_desktop_config.json to Claude configuration directory. Don't forget to populate ENV variables!

On Mac: ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows: AppData\Claude\claude_desktop_config.json

Usage with Claude Desktop
{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UPCLOUD_USERNAME",
        "-e",
        "UPCLOUD_PASSWORD",
        "ghcr.io/marinx/upcloud-mcp-server"
      ],
      "env": {
        "UPCLOUD_USERNAME": "<YOUR_USERNAME>",
        "UPCLOUD_PASSWORD": "<YOUR_PASSWORD>"
      }
    }
  }
}

tools ask

Tools

Account
  • get_account - Get account of current user
  • get_account_details - Get account details by username
    • username: Account username (string, required)
  • get_account_list - Get account list
Database
  • get_database - Get managed database by uuid
    • uuid: Database UUID (string, required)
Server
  • get_servers - Get servers
  • get_server_details - Get server details
    • uuid: Server UUID (string, required)
Kubernetes
  • get_kubernetes_clusters - Get kubernetes clusters
  • get_kubernetes_cluster - Get kubernetes cluster
    • uuid: Cluster UUID (string, required)
  • get_kubernetes_plans - Get kubernetes plans

License

This project is licensed under the terms of the MIT open source license. Please refer to MIT for the full terms.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.