mcp-server-cvm 0.1.12
MCP Server for Tencent Cloud CVM
Requires Python: >=3.10

# Tencent Cloud CVM MCP Server
Implementation of Tencent Cloud CVM (Cloud Virtual Machine) and VPC (Virtual Private Cloud) MCP server for managing Tencent Cloud instances and network resources.

## Features
- **Instance Management**: Full lifecycle management including creating, starting, stopping, restarting, and terminating instances
- **Instance Query**: Query instance lists and instance type configurations  
- **Image Management**: Query available image lists
- **Network Management**: Query network resources like VPCs, subnets, and security groups
- **Region Management**: Query available regions and availability zones

## API List
### Instance Management
#### DescribeInstances
Query instance list.

**Input Parameters**:
- `Region` (string): Region, e.g., ap-guangzhou
- `Offset` (integer, optional): Offset, default 0
- `Limit` (integer, optional): Number of results, default 20, max 100  
- `InstanceIds` (array[string], optional): Filter by instance ID(s)

#### RunInstances  
Create instance(s).

**Input Parameters**:
- `Region` (string): Region
- `Zone` (string): Availability zone
- `InstanceType` (string): Instance type  
- `ImageId` (string): Image ID
- `VpcId` (string): VPC ID
- `SubnetId` (string): Subnet ID
- `InstanceName` (string, optional): Instance name
- `SecurityGroupIds` (array[string], optional): Security group ID list
- `Password` (string, optional): Instance password
- `InstanceChargeType` (string, optional): Billing type: PREPAID or POSTPAID_BY_HOUR

#### StartInstances
Start instance(s).

**Input Parameters**:
- `Region` (string): Region  
- `InstanceIds` (array[string]): Instance ID list

#### StopInstances
Stop instance(s).

**Input Parameters**:
- `Region` (string): Region
- `InstanceIds` (array[string]): Instance ID list  
- `StopType` (string, optional): Shutdown type: SOFT/HARD/SOFT_FIRST
- `StoppedMode` (string, optional): Shutdown mode: KEEP_CHARGING/STOP_CHARGING

#### RebootInstances
Reboot instance(s).

**Input Parameters**:
- `Region` (string): Region
- `InstanceIds` (array[string]): Instance ID list
- `StopType` (string, optional): Shutdown type: SOFT/HARD/SOFT_FIRST

#### TerminateInstances
Terminate instance(s).

**Input Parameters**:
- `Region` (string): Region
- `InstanceIds` (array[string]): Instance ID list

#### ResetInstancesPassword
Reset instance password.

**Input Parameters**:
- `Region` (string): Region
- `InstanceIds` (array[string]): Instance ID list
- `Password` (string): New password
- `ForceStop` (boolean, optional): Whether to force shutdown

#### CreateDiagnosticReports
Create diagnostic reports for instances.

**Input Parameters**:
- `Region` (string): Region, e.g., ap-guangzhou
- `InstanceIds` (array[string]): Instance ID list

#### DescribeDiagnosticReports
Query diagnostic reports for instances.

**Input Parameters**:
- `Region` (string): Region, e.g., ap-guangzhou
- `ReportIds` (array[string], optional): List of diagnostic report IDs, e.g., ["dr-rfmme2si"]. Maximum 100 report IDs per request
- `Filters` (array[object], optional): List of filters. Supported filters:
  - `instance-id`: Filter by instance ID, e.g., ins-8jqq9ajy
  - `instance-name`: Filter by instance name, e.g., my-ins
  - `instance-health-status`: Filter by instance health status. Values: Normal, Warn, Critical
  - `report-status`: Filter by report status. Values: Querying, Finished
  - `cluster-ids`: Filter by cluster IDs, e.g., ['hpc-rltlmf6v']
- `VagueInstanceName` (string, optional): Fuzzy instance alias
- `Offset` (integer, optional): Offset, default is 0
- `Limit` (integer, optional): Number of results per page, default is 20, maximum is 100
- `ClusterDiagnosticReportIds` (array[string], optional): List of cluster diagnostic report IDs, e.g., ["cr-rfmme2si"]
- `ScenarioId` (integer, optional): Scenario ID. Default is 1 for comprehensive CVM check, 200 for cluster consistency check

**Note**:
- `ReportIds` and `ClusterDiagnosticReportIds` cannot be used together with `Filters` or `VagueInstanceName`

### Configuration Query
#### DescribeRegions
Query region list.

**Input Parameters**: None

#### DescribeZones
Query availability zone list.

**Input Parameters**:
- `Region` (string): Region

#### DescribeInstanceTypeConfigs
Query instance type configurations.

**Input Parameters**:
- `Region` (string): Region
- `Zone` (string, optional): Availability zone
- `InstanceFamily` (string, optional): Instance family

#### DescribeImages
Query image list.

**Input Parameters**:
- `Region` (string): Region
- `ImageIds` (array[string], optional): Image ID list

### Network Resources
#### DescribeVpcs
Query VPC list.

**Input Parameters**:
- `Region` (string): Region
- `VpcIds` (array[string], optional): VPC ID list

#### DescribeSubnets
Query subnet list.

**Input Parameters**:
- `Region` (string): Region
- `VpcId` (string, optional): VPC ID
- `SubnetIds` (array[string], optional): Subnet ID list

#### DescribeSecurityGroups
Query security group list.

**Input Parameters**:
- `Region` (string): Region
- `SecurityGroupIds` (array[string], optional): Security group ID list

## Configuration
### Set Tencent Cloud Credentials
1. Obtain SecretId and SecretKey from Tencent Cloud Console
2. Set default region (optional)

### Environment Variables
Configure the following environment variables:
- `TENCENTCLOUD_SECRET_ID`: Tencent Cloud SecretId
- `TENCENTCLOUD_SECRET_KEY`: Tencent Cloud SecretKey  
- `TENCENTCLOUD_REGION`: Default region (optional)

### Usage in Claude Desktop
Add the following configuration to claude_desktop_config.json:

```json
{
  "mcpServers": {
    "tencent-cvm": {
      "command": "uv",
      "args": [
        "run",
        "mcp-server-cvm"
      ],
      "env": {
        "TENCENTCLOUD_SECRET_ID": "YOUR_SECRET_ID_HERE",
        "TENCENTCLOUD_SECRET_KEY": "YOUR_SECRET_KEY_HERE",
        "TENCENTCLOUD_REGION": "YOUR_REGION_HERE"
      }
    }
  }
}
```

## Installation
```sh
pip install mcp-server-cvm
```

## License
MIT License. See LICENSE file for details.