Ucloud MCP Server

🚀 UCloud MCP Server

A cloud instance management server based on MCP-Go and UCloud SDK, supporting the management of UCloud instances through the MCP protocol.

✨ Features

• Query instance information
• List all instances
• Get instance status
• Monitor instance performance metrics
• Support for the MCP protocol
• Support for configuration files

📦 Dependencies

• Go 1.23 or higher
• UCloud account and API credentials

🛠️ Configuration

The service supports two configuration methods:

1. Configuration File (Recommended)

Create a config.json file:

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

2. Environment Variables

If not specified in the configuration file, the service will attempt to read from environment variables:

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

Configuration priority: Configuration file > Environment variables

🚀 Quick Start

1. Clone the repository:

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

2. Install dependencies:

go mod download

3. Build the service:

go build -o ucloud-mcp-server

4. Run the service:

Basic Usage

./ucloud-mcp-server

Advanced Usage

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

Available startup options:

• --config: Specify the path to the configuration file (default: ./config.json)
• --port: Specify the listening port (default: 8080)

The service will provide MCP protocol support through standard input/output.

💻 Usage Examples

Instance Information

Get detailed information about a specific instance, including:

• Basic instance details
• Configuration information
• Current status
• Resource allocation

Instance Status

Monitor the current running status of any instance in real-time.

Instance Metrics

Access comprehensive instance monitoring metrics, including:

• CPU usage
• Disk I/O operations
• Network traffic statistics
• System performance data

Instance List

View a complete list of all available instances under your account, including their basic information and current status.

📊 Monitoring Metrics

• There may be a delay of a few minutes.
• Regularly check monitoring metrics to detect potential issues early.