Back to MCP directory
publicPublicdnsLocal runtime

upcloud-mcp-server

Upcloud MCP Server是一个基于Model Context Protocol的服务,用于与Upcloud API无缝集成,为开发者提供自动化功能和交互能力。目前仍在开发中,尚未准备好正式使用。

article

README

🚀 Upcloud MCP 服务器

Upcloud MCP 服务器与 Upcloud API 集成,借助 模型上下文协议 (MCP),为开发者和工具提供无缝集成体验,实现高级自动化和交互功能。其灵感源自 Github MCP 服务器

🚀 快速开始

此项目尚未准备好用于任何类型的使用,请稍后再查看更新。

✨ 主要特性

  • 与 Upcloud API 集成,实现无缝交互。
  • 支持从 Upcloud 服务中提取和分析数据。
  • 可构建具有 AI 功能的工具和应用程序,与 Upcloud 生态系统互动。

📦 安装指南

先决条件

  1. 要在容器中运行服务器,您需要安装 Docker
  2. 安装 Docker 后,还需要确保 Docker 正在运行。
  3. 最后,您需要填充 UPCLOUD_USERNAME 和 UPCLOUD_PASSWORD 环境变量。

安装步骤

本地使用

go build cmd/upcloud-mcp-server

并将二进制文件移动到您的 bin 目录,并将 claude_desktop_config.json 移动到 Claude 配置目录。别忘了填充环境变量!

  • 在 Mac 上:~/Library/Application\ Support/Claude/claude_desktop_config.json
  • 在 Windows 上:AppData\Claude\claude_desktop_config.json

与 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

💻 使用示例

工具使用示例

账户相关

  • get_account - 获取当前用户的账户
  • get_account_details - 根据用户名获取账户详情
    • username: 账户用户名(字符串,必需)
  • get_account_list - 获取账户列表

数据库相关

  • get_database - 根据 UUID 获取管理数据库
    • uuid: 数据库 UUID(字符串,必需)

服务器相关

  • get_servers - 获取服务器
  • get_server_details - 获取服务器详情
    • uuid: 服务器 UUID(字符串,必需)

Kubernetes 相关

  • get_kubernetes_clusters - 获取 Kubernetes 集群
  • get_kubernetes_cluster - 根据 UUID 获取 Kubernetes 集群
    • uuid: 集群 UUID(字符串,必需)
  • get_kubernetes_plans - 获取 Kubernetes 计划

📄 许可证

此项目根据 MIT 开源许可协议授权。请参阅 MIT 以获取完整条款。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client