UCloud MCP Server

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

# UCloud MCP Server

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

## 特性

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

## 要求

- Go 1.23 或更高版本
- UCloud 账户和 API 凭证

## 配置

该服务支持两种配置方法：

### 1. 配置文件 (推荐)

创建一个 `config.json` 文件：

```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 地域
export UCLOUD_PROJECT_ID="your-project-id"  # 项目 ID
export UCLOUD_PUBLIC_KEY="your-public-key"  # API 公钥
export UCLOUD_PRIVATE_KEY="your-private-key"  # API 私钥

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

安装和运行

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)

示例：

# 使用自定义配置文件
./ucloud-mcp-server --config /etc/ucloud/config.json

# 使用自定义端口
./ucloud-mcp-server --port 9000

# 同时使用自定义配置和端口
./ucloud-mcp-server --config /etc/ucloud/config.json --port 9000

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

可用操作

实例信息

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

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

实例状态

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

实例指标

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

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

实例列表

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

监控指标

系统提供以下监控指标：

• CPU 指标

  • CPUUtilization: CPU 使用率 (%)

• 磁盘指标

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

• 网络指标

  • NICIn: 网络入站流量 (bytes/s)
  • NICOut: 网络出站流量 (bytes/s)
  • NetPacketIn: 入站网络数据包数
  • NetPacketOut: 出站网络数据包数

重要提示

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