腾讯云私有域解析

私有域解析（Private DNS）是基于腾讯云私有网络（VPC）的私有域名解析和管理服务。

功能特性

• 私有 DNS 信息查询： 查询域名列表、私有域列表、私有域信息、私有域记录列表等。
• DNS 解析统计： 获取私有域解析请求的数量。

API 列表

DescribeDomainList

获取域名列表。

输入参数：

• Type (字符串, 可选): 域名分组类型。
• Offset (整数, 可选): 偏移量，默认值为 0。
• Limit (整数, 可选): 返回结果数量，默认值为 20，最大值为 100。
• GroupId (整数, 可选): 分组 ID，传入后可获取指定分组下的所有域名。
• Keyword (整数, 可选): 搜索域名的关键词。
• Tags (字符串数组, 可选): 根据标签过滤。

CreatePrivateZone

创建私有域。

输入参数：

• Action (字符串, 必填): 公共参数，本 API 的值为 CreatePrivateZone。
• Version (字符串, 必填): 公共参数，本 API 的值为 2020-10-28。
• Domain (字符串, 必填): 域名，必须符合 IANA 规范的标准 TLD 格式。 示例: a.com
• TagSet.N (TagInfo 数组, 可选): 私有域绑定的标签。
• VpcSet.N (VpcInfo 数组, 可选): 私有域关联的 VPC。
• Remark (字符串, 可选): 备注。 示例: Test domain
• DnsForwardStatus (字符串, 可选): 是否开启子域递归。取值: ENABLED (开启), DISABLED (关闭)。默认值: ENABLED。 示例: ENABLED
• AccountVpcSet.N (AccountVpcInfo 数组, 可选): 关联账号下的 VPC 绑定到私有域。
• CnameSpeedupStatus (字符串, 可选): 是否开启 CNAME 加速。取值: ENABLED (开启), DISABLED (关闭)。默认值: ENABLED。 示例: ENABLED

DescribePrivateZone

获取私有域信息。

输入参数：

• Action (字符串, 必填): 公共参数，本 API 的值为 DescribePrivateZone。
• Version (字符串, 必填): 公共参数，本 API 的值为 2020-10-28。
• ZoneId (字符串, 必填): 私有域 ID。 示例: zone-dm1igr1

DescribePrivateZoneList

获取私有域列表。

输入参数：

• Action (字符串, 必填): 公共参数，本 API 的值为 DescribePrivateZoneList。
• Version (字符串, 必填): 公共参数，本 API 的值为 2020-10-28。
• Region (字符串, 可选): 公共参数，此接口无需传递该参数。
• Offset (整数, 可选): 分页偏移量，从 0 开始。 示例: 1
• Limit (整数, 可选): 分页限制，最大 100，默认 20。 示例: 10
• Filters.N (Filter 数组, 可选): 过滤参数。

DescribePrivateZoneRecordList

获取私有域解析记录列表。

输入参数：

• Action (字符串, 必填): 公共参数，本 API 的值为 DescribePrivateZoneRecordList。
• Version (字符串, 必填): 公共参数，本 API 的值为 2020-10-28。
• Region (字符串, 可选): 公共参数，此接口无需传递该参数。
• ZoneId (字符串, 必填): 私有域 ID。 示例: zone-12c5a6e8
• Filters.N (Filter 数组, 可选): 过滤参数（支持通过 Value 和 RecordType 过滤）。
• Offset (整数, 可选): 分页偏移量，从 0 开始。 示例: 0
• Limit (整数, 可选): 分页限制，最大 200，默认 20。 示例: 200

DescribeRequestData

获取私有域请求量。

输入参数：

• Action (字符串, 必填): 公共参数，本 API 的值为 DescribeRequestData。
• Version (字符串, 必填): 公共参数，本 API 的值为 2020-10-28。
• Region (字符串, 可选): 公共参数，此接口无需传递该参数。
• TimeRangeBegin (字符串, 必填): 请求量统计的开始时间，格式: 2020-11-22 00:00:00。 示例: 2020-11-22 00:00:00
• TimeRangeEnd (字符串, 可选): 请求量统计的结束时间，格式: 2020-11-22 23:59:59。 示例: 2020-11-23 23:59:59
• Filters.N (Filter 数组, 可选): 过滤参数。
• Export (布尔值, 可选): 是否导出: true 表示导出，false 表示不导出。 示例: true

配置

设置腾讯云凭证

1. 从腾讯云控制台获取 SecretId 和 SecretKey。
2. 设置默认区域（可选）。

环境变量

配置以下环境变量：

• TENCENTCLOUD_SECRET_ID: 腾讯云 SecretId
• TENCENTCLOUD_SECRET_KEY: 腾讯云 SecretKey
• TENCENTCLOUD_REGION: 默认区域（可选）

在 Claude Desktop 中使用

将以下配置添加到 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "tencent-privatedns": {
      "command": "uv",
      "args": [
        "run",
        "mcp-server-privatedns"
      ],
      "env": {
        "TENCENTCLOUD_SECRET_ID": "YOUR_SECRET_ID_HERE",
        "TENCENTCLOUD_SECRET_KEY": "YOUR_SECRET_KEY_HERE",
        "TENCENTCLOUD_REGION": "ap-guangzhou"  //可选参数，用于指定腾讯云 API 的区域，默认值为 ap-guangzhou。
      }
    }
  }
}

Installation

pip install mcp-server-privatedns

License

MIT许可证，详情请参阅LICENSE文件。

Tencent Cloud PrivateDNS

Private DNS is a private domain name resolution and management service based on Tencent Cloud's Virtual Private Cloud (VPC).

Features

• PrivateDNS information query: Query domain lists, private domain lists, private domain information, private domain record lists, etc.
• DNS resolution statistics: Get the number of private domain resolution requests.

API List

DescribeDomainList

Get the list of domains.

Input Parameters:

• Type (string, optional): The domain group type.
• Offset (integer, optional): Offset, default 0.
• Limit (integer, optional): Number of results, default 20, max 100.
• GroupId (integer, optional): Group ID, which can be passed in to get all domains in the specified group.
• Keyword (integer, optional) Keyword for searching for a domain.
• Tags (array[string], optional): Filter by Tags.

CreatePrivateZone

Create Private Zone

Input Parameters:

• Action (string, required): Common parameter, value for this API: CreatePrivateZone.
• Version (string, required): Common parameter, value for this API: 2020-10-28.
• Domain (string, required): Domain name, must be a standard TLD format. Example: a.com
• TagSet.N (array of TagInfo, optional): Tags to bind to the private domain.
• VpcSet.N (array of VpcInfo, optional): VPCs to associate with the private domain.
• Remark (string, optional): Remarks. Example: Test domain
• DnsForwardStatus (string, optional): Whether to enable subdomain recursion. Values: ENABLED, DISABLED. Default: ENABLED. Example: ENABLED
• AccountVpcSet.N (array of AccountVpcInfo, optional): VPCs from associated accounts to bind to the private domain.
• CnameSpeedupStatus (string, optional): Whether to enable CNAME acceleration. Values: ENABLED, DISABLED. Default: ENABLED. Example: ENABLED

DescribePrivateZone

Get Private Zone information

Input Parameters:

• Action (string, required): Common parameter, value for this API: DescribePrivateZone.
• Version (string, required): Common parameter, value for this API: 2020-10-28.
• ZoneId (string, required): Private zone ID. Example: zone-dm1igr1

DescribePrivateZoneList

Obtain the list of private zones.

Input Parameters:

• Action (string, required): Common parameter, value for this API: DescribePrivateZoneList.
• Version (string, required): Common parameter, value for this API: 2020-10-28.
• Region (string, optional): Common parameter, this interface does not need to pass this parameter.
• Offset (integer, optional): Pagination offset, starting from 0. Example: 1
• Limit (integer, optional): Pagination limit, maximum 100, default 20. Example: 10
• Filters.N (array of Filter, optional): Filtering parameters.

DescribePrivateZoneRecordList

Describe Private Zone Record List

Input Parameters:

• Action (string, required): Common parameter, value for this API: DescribePrivateZoneRecordList.
• Version (string, required): Common parameter, value for this API: 2020-10-28.
• Region (string, optional): Common parameter, this interface does not need to pass this parameter.
• ZoneId (string, required): Private zone ID. Example: zone-12c5a6e8
• Filters.N (array of Filter, optional): Filtering parameters (supports filtering by Value and RecordType).
• Offset (integer, optional): Pagination offset, starting from 0. Example: 0
• Limit (integer, optional): Pagination limit, maximum 200, default 20. Example: 200

DescribeRequestData

Describe Private Zone Request Volume

Input Parameters:

• Action (string, required): Common parameter, value for this API: DescribeRequestData.
• Version (string, required): Common parameter, value for this API: 2020-10-28.
• Region (string, optional): Common parameter, this interface does not need to pass this parameter.
• TimeRangeBegin (string, required): Start time for request volume statistics, format: 2020-11-22 00:00:00. Example: 2020-11-22 00:00:00
• TimeRangeEnd (string, optional): End time for request volume statistics, format: 2020-11-22 23:59:59. Example: 2020-11-23 23:59:59
• Filters.N (array of Filter, optional): Filtering parameters.
• Export (boolean, optional): Whether to export: true to export, false not to export. Example: true

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-privatedns": {
      "command": "uv",
      "args": [
        "run",
        "mcp-server-privatedns"
      ],
      "env": {
        "TENCENTCLOUD_SECRET_ID": "YOUR_SECRET_ID_HERE",
        "TENCENTCLOUD_SECRET_KEY": "YOUR_SECRET_KEY_HERE",
        "TENCENTCLOUD_REGION": "ap-guangzhou"  //optional parameter, to specify the region of tencent cloud API, default value is ap-guangzhou.
      }
    }
  }
}

Installation

pip install mcp-server-privatedns

License

MIT License. See LICENSE file for details.