mcp-server-cvm 0.1.8

MCP Server for Tencent Cloud CVM

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:

{
  "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

pip install mcp-server-cvm

License

MIT License. See LICENSE file for details.