UCloud MCP Server

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

Features

- Query instance information
- List all instances
- Get instance status
- Monitor instance performance metrics
- MCP protocol support
- Configuration file support

Requirements

- 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 try 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

Installation and Running

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

With custom configuration:

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

Available startup options:
- --config: Specify the path to your configuration file (default: ./config.json)
- --port: Specify the port to listen on (default: 8080)

Examples:
```bash