返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端