Ucloud MCP Server

🚀 UCloud MCP 服務器

UCloud MCP 服務器是一個基於 MCP - Go 和 UCloud SDK 構建的雲實例管理服務器，它支持通過 MCP 協議對 UCloud 實例進行高效管理，為用戶提供便捷的實例管理體驗。

✨ 主要特性

• 🔍 查詢實例信息：可精準獲取特定實例的詳細內容。
• 📋 列出所有實例：查看賬戶下所有可用實例的完整列表。
• 📊 獲取實例狀態：即時掌握實例的當前運行狀態。
• 📈 監控實例性能指標：提供如 CPU 使用率、磁盤 I/O 操作等全面的監控數據。
• 📡 支持 MCP 協議：通過標準輸入/輸出提供 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 區域
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

高級用法

# 使用自定義配置文件和端口運行服務
./ucloud-mcp-server --config /path/to/config.json --port 8080

📚 詳細文檔

可用操作

實例信息

獲取特定實例的詳細信息，包括：

• 基本實例詳情
• 配置信息
• 當前狀態
• 資源分配

實例狀態

即時監控任何實例的當前運行狀態。

實例指標

訪問全面的實例監控指標，包括：

• CPU 使用率
• 磁盤 I/O 操作
• 網絡流量統計
• 系統性能數據

實例列表

查看您賬戶下所有可用實例的完整列表，包括其基本信息和當前狀態。

監控指標

• 可能會有幾分鐘的延遲
• 定期檢查監控指標以儘早發現潛在問題