UCloud MCP Server

 _    _ _____ _                 _ 
| |  | /  __ \ |               | |
| |  | | /  \/ | ___  _   _  __| |
| |  | | |   | |/ _ \| | | |/ _` |
| |__| | \__/\ | (_) | |_| | (_| |
 \____/ \____/_|\___/ \__,_|\__,_|
                                  
 __  __  _____ _____   _____                          
|  \/  |/  __ \  __ \ /  ___|                         
| .  . || /  \/| |_/ / \ `--.  ___ _ ____   _____ _ __
| |\/| || |    |  __/   `--. \/ _ \ '__\ \ / / _ \ '__|
| |  | || \__/\| |     /\__/ /  __/ |   \ V /  __/ |   
\_|  |_/ \____/\_|     \____/ \___|_|    \_/ \___|_|   

UCloud MCP 服务

基于 MCP-Go 和 UCloud SDK 构建的云实例管理服务，支持通过 MCP 协议管理 UCloud 实例。

功能

• 查询实例信息
• 列出所有实例
• 获取实例状态
• 监控实例性能指标
• 支持 MCP 协议
• 支持配置文件

要求

• Go 1.23 或更高版本
• UCloud 账号和 API 凭证

配置

服务支持两种配置方式：

1. 配置文件（推荐）

创建 config.json 文件：

{
    "region": "cn-bj2",
    "project_id": "your-project-id",
    "public_key": "your-public-key",
    "private_key": "your-private-key"
}

2. 环境变量

如果配置文件中未指定，服务将尝试从环境变量中读取：

export UCLOUD_REGION="cn-bj2"        # UCloud region
export UCLOUD_PROJECT_ID="your-project-id"  # Project ID
export UCLOUD_PUBLIC_KEY="your-public-key"  # API public key
export UCLOUD_PRIVATE_KEY="your-private-key"  # API private key

配置优先级：配置文件 > 环境变量

安装和运行

1. 克隆仓库：

git clone https://github.com/renzheng.wang/ucloud-mcp-server.git
cd ucloud-mcp-server

2. 安装依赖：

go mod download

3. 构建服务：

go build -o ucloud-mcp-server

4. 运行服务：

基本用法：

./ucloud-mcp-server

使用自定义配置：

./ucloud-mcp-server --config /path/to/config.json --port 8080

可用的启动选项：

• --config：指定配置文件的路径（默认：./config.json）
• --port：指定监听端口（默认：8080）

示例：

# Use custom config file
./ucloud-mcp-server --config /etc/ucloud/config.json

# Use custom port
./ucloud-mcp-server --port 9000

# Use both custom config and port
./ucloud-mcp-server --config /etc/ucloud/config.json --port 9000

服务将通过标准输入/输出提供 MCP 协议服务。

可用操作

实例信息

获取特定实例的详细信息，包括：

• 实例基本详情
• 配置信息
• 当前状态
• 资源分配

实例状态

实时监控任意实例的当前运行状态。

实例指标

访问实例的全面监控指标，包括：

• CPU 利用率
• 磁盘 I/O 操作
• 网络流量统计
• 系统性能数据

实例列表

查看账号中所有可用实例的完整列表，包括其基本信息和当前状态。

监控指标

系统提供以下监控指标：

• CPU 指标

  • CPUUtilization：CPU 使用率（%）

• 磁盘指标

  • IORead：磁盘读取速率
  • IOWrite：磁盘写入速率
  • DiskReadOps：磁盘读取操作次数
  • DiskWriteOps：磁盘写入操作次数

• 网络指标

  • NICIn：网络入站流量（字节/秒）
  • NICOut：网络出站流量（字节/秒）
  • NetPacketIn：网络入站数据包数量
  • NetPacketOut：网络出站数据包数量

重要说明

• 妥善保管 UCloud API 凭证
• 在生产环境中，使用配置文件或密钥管理服务保存敏感信息
• 所有操作均通过支持标准 I/O 的 MCP 协议执行
• 监控数据可能会延迟几分钟
• 定期检查监控指标，以尽早发现潜在问题