civo
List Civo instances, Kubernetes clusters, networks and DNS; reboot instances, add rules.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"civo": {
"url": "https://civo.usefulapi.io/mcp"
}
}
}遠端端點
https://civo.usefulapi.io/mcpstreamable-http它能做什麼
工具清單
工具（22）
🟢civo_list_regions
List the Civo regions available to the account, with which one is the default, whether each is out of capacity, and the features each supports (IaaS, Kubernetes, object store, load balancers, GPU, databases). A cheap way to confirm the API key works. Civo: GET /v2/regions.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_get_quota
The account's limits and current usage: instances, CPU cores, RAM, disk, volumes, snapshots, public IPs, networks, firewalls and rules, load balancers, object storage and databases. Answers 'can I launch another one?'. Civo: GET /v2/quota.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_charges(from, to)
List billable usage for a period: each resource's product code, label, region, time span and hours (size_gb for volumes). The range may be at most 31 days; defaults to the start of the current month until now. Civo: GET /v2/charges.
輸入結構描述
{
"type": "object",
"properties": {
"from": {
"description": "Start, RFC 3339 (e.g. 2026-09-01T00:00:00Z). Defaults to the start of this month.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$"
},
"to": {
"description": "End, RFC 3339. Defaults to now. At most 31 days after `from`.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_instance_sizes(region)
List the sizes (plans) that can be launched — instances, Kubernetes nodes and databases — with CPU cores, RAM, disk, transfer allowance and GPU. Civo: GET /v2/sizes.
輸入結構描述
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_instances(region, tags, page, per_page)
List compute instances in a region, optionally filtered by tags. Paginated: returns {page, per_page, pages, items}. Passwords are redacted. Civo: GET /v2/instances.
輸入結構描述
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
},
"tags": {
"description": "Only instances carrying these tags.",
"type": "array",
"items": {
"type": "string",
"pattern": "^[^\\s]+$"
}
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"per_page": {
"description": "Items per page, 1-100 (Civo default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_get_instance(instance_id, region)
Fetch one instance: status, size, CPU/RAM/disk, public and private IPs, network, firewall, tags, attached volumes and source image. Passwords are redacted. Civo: GET /v2/instances/{id}.
輸入結構描述
{
"type": "object",
"properties": {
"instance_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The instance's id (a UUID)."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"instance_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_kubernetes_clusters(region, page, per_page)
List the Kubernetes (K3s/Talos) clusters in a region with status, version, node pools, API endpoint and installed applications. Paginated: {page, per_page, pages, items}. Kubeconfigs are redacted. Civo: GET /v2/kubernetes/clusters.
輸入結構描述
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"per_page": {
"description": "Items per page, 1-100 (Civo default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_get_kubernetes_cluster(cluster_id, region)
Fetch one Kubernetes cluster: status, readiness, conditions, version and available upgrade, pools and their instances, network, firewall, CNI and installed marketplace apps. The kubeconfig is redacted. Civo: GET /v2/kubernetes/clusters/{id}.
輸入結構描述
{
"type": "object",
"properties": {
"cluster_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The cluster's id (a UUID)."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"cluster_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_networks(region)
List the private networks in a region: label, CIDR, whether it is the default network, status and nameservers. Civo: GET /v2/networks.
輸入結構描述
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_firewalls(region)
List the firewalls in a region with their network, rule count and how many instances, clusters and load balancers use each. Civo: GET /v2/firewalls.
輸入結構描述
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_firewall_rules(firewall_id, region)
List the rules of one firewall: protocol, port range, CIDRs, direction (ingress/egress), action (allow/deny) and label — the answer to 'what is exposed to the internet?'. Civo: GET /v2/firewalls/{id}/rules.
輸入結構描述
{
"type": "object",
"properties": {
"firewall_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The firewall's id (a UUID)."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"firewall_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_load_balancers(region)
List the load balancers in a region: algorithm, backends (IP, protocol, source/target ports), public IP, state and the Kubernetes service each fronts. Civo: GET /v2/loadbalancers.
輸入結構描述
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_volumes(region)
List the block-storage volumes in a region: size, status, type, and the instance or cluster each is attached to (unattached volumes still bill). Civo: GET /v2/volumes.
輸入結構描述
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_databases(region, page, per_page)
List the managed databases (MySQL, PostgreSQL) in a region: software and version, size, nodes, IPs, port, network, firewall and status. Paginated: {page, per_page, pages, items}. Passwords are redacted. Civo: GET /v2/databases.
輸入結構描述
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"per_page": {
"description": "Items per page, 1-100 (Civo default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_dns_domains
List the domains whose DNS Civo hosts for the account. Civo: GET /v2/dns.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_dns_records(domain_id, type, name)
List the records of one hosted domain (name, type, value, priority, TTL), optionally filtered by type or name. Civo: GET /v2/dns/{domain_id}/records.
輸入結構描述
{
"type": "object",
"properties": {
"domain_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The DNS domain's id (a UUID)."
},
"type": {
"description": "Only records of this type.",
"type": "string",
"enum": [
"a",
"cname",
"mx",
"txt",
"srv",
"ns"
]
},
"name": {
"description": "Only records with this name (e.g. www, or @ for the apex).",
"type": "string",
"maxLength": 253
}
},
"required": [
"domain_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_reboot_instance(instance_id, type, region)
Reboot one instance. `soft` (default) asks the OS to restart cleanly; `hard` cuts power and boots it again, like pulling the plug — use only when soft does not work. Causes brief downtime. Civo: POST /v2/instances/{id}/soft_reboots or /hard_reboots.
輸入結構描述
{
"type": "object",
"properties": {
"instance_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The instance's id (a UUID)."
},
"type": {
"description": "soft (default) or hard.",
"type": "string",
"enum": [
"soft",
"hard"
]
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"instance_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_stop_instance(instance_id, region)
Power off one instance. Anything it serves goes offline until it is started again with civo_start_instance. A stopped instance is still billed. Civo: PUT /v2/instances/{id}/stop.
輸入結構描述
{
"type": "object",
"properties": {
"instance_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The instance's id (a UUID)."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"instance_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_start_instance(instance_id, region)
Boot a stopped instance. Undoes civo_stop_instance. Civo: PUT /v2/instances/{id}/start.
輸入結構描述
{
"type": "object",
"properties": {
"instance_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The instance's id (a UUID)."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"instance_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_set_instance_tags(instance_id, tags, region)
REPLACE the full tag list of one instance (tags are used for filtering and by load-balancer instance pools, so changing them can move an instance in or out of a pool). Pass the complete desired list; an empty list clears all tags. Civo: PUT /v2/instances/{id}/tags.
輸入結構描述
{
"type": "object",
"properties": {
"instance_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The instance's id (a UUID)."
},
"tags": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"pattern": "^[^\\s]+$"
},
"description": "The complete new tag list."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"instance_id",
"tags"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_create_firewall_rule(firewall_id, protocol, start_port, end_port, cidr, ...)
Add one rule to a firewall — e.g. allow TCP 443 ingress from 0.0.0.0/0. This changes what is reachable on every instance, cluster and load balancer using the firewall, so prefer narrow CIDRs. Undo by deleting the rule in the Civo dashboard or CLI. Civo: POST /v2/firewalls/{id}/rules.
輸入結構描述
{
"type": "object",
"properties": {
"firewall_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The firewall's id (a UUID)."
},
"protocol": {
"type": "string",
"enum": [
"tcp",
"udp",
"icmp"
],
"description": "tcp, udp or icmp."
},
"start_port": {
"description": "First port, e.g. \"443\". Required unless protocol is icmp.",
"type": "string",
"pattern": "^\\d{1,5}$"
},
"end_port": {
"description": "Last port of a range. Omit for a single port.",
"type": "string",
"pattern": "^\\d{1,5}$"
},
"cidr": {
"description": "Source (ingress) or destination (egress) CIDRs. Civo defaults to 0.0.0.0/0 — the whole internet.",
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F:.]+\\/\\d{1,3}$"
}
},
"direction": {
"description": "ingress (default) or egress.",
"type": "string",
"enum": [
"ingress",
"egress"
]
},
"action": {
"description": "allow (default) or deny.",
"type": "string",
"enum": [
"allow",
"deny"
]
},
"label": {
"description": "A display name for the rule.",
"type": "string",
"maxLength": 100
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"firewall_id",
"protocol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_create_dns_record(domain_id, type, name, value, priority, ...)
Add one record to a Civo-hosted domain. Live DNS changes propagate to the world; undo by deleting the record in the Civo dashboard or CLI. Civo: POST /v2/dns/{domain_id}/records.
輸入結構描述
{
"type": "object",
"properties": {
"domain_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The DNS domain's id (a UUID)."
},
"type": {
"type": "string",
"enum": [
"A",
"CNAME",
"MX",
"TXT",
"SRV",
"NS"
],
"description": "Record type."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 253,
"description": "The subdomain part, e.g. www, or @ for the apex."
},
"value": {
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "An IP address, hostname or text value."
},
"priority": {
"description": "Priority, for MX/SRV records (Civo default 10).",
"type": "integer",
"minimum": 0,
"maximum": 65535
},
"ttl": {
"description": "TTL in seconds; Civo's minimum and default is 600.",
"type": "integer",
"minimum": 600,
"maximum": 604800
}
},
"required": [
"domain_id",
"type",
"name",
"value"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社群
證據