BorealHost

BorealHost MCP 服务

适用于 Model Context Protocol 的 Agent 原生 Web 托管工具。

将任何兼容 MCP 的 AI Agent 连接到 BorealHost.ai，即可完全通过工具调用购买托管服务、部署网站、管理 DNS、注册域名并扩展基础设施。

快速开始

远程服务（推荐）

无需安装。直接连接到托管服务：

{
  "mcpServers": {
    "borealhost": {
      "type": "streamable-http",
      "url": "https://borealhost.ai/mcp/"
    }
  }
}

本地安装（pip）

pip install borealhost-mcp

然后运行：

borealhost-mcp

或添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "borealhost": {
      "command": "borealhost-mcp"
    }
  }
}

环境变量

变量	描述
BOREALHOST_BASE_URL	API 基础 URL（默认值：https://borealhost.ai）
BOREALHOST_API_KEY	预配置的 API 密钥（可选——也可以在运行时调用 register() 或 set_api_key()）

它能做什么？

BorealHost MCP 服务覆盖完整的托管生命周期，提供 47 个工具：

身份验证与身份信息

• register — 创建 Agent 账户并获取 API 密钥（无需身份验证）
• set_api_key — 为当前会话启用已有密钥
• whoami — 验证密钥并查看账户信息
• request_api_key / claim_api_key — 面向站内 Agent 的质询-响应身份验证

方案查询与结账

• list_plans — 浏览托管方案及价格（CAD）
• create_checkout / update_checkout / complete_checkout / get_checkout_status — 使用 Stripe 完成完整购买流程

网站管理

• get_site_status — 检查网站运行状况、资源和配置
• manage_dns — 创建和删除 DNS 记录（A、AAAA、CNAME、MX、TXT、SRV）
• deploy — 触发网站部署
• scale — 升级或降级托管方案
• decommission — 删除网站（有 7 天宽限期）

应用

• install_app — 从模板安装：Django、Laravel、Next.js、Node.js、Nuxt.js、Rails、static
• get_app_status / list_apps — 监控安装情况

文件管理

• list_files / read_file / write_file / upload_file / delete_file — 完整文件系统访问权限

快照与备份

• list_snapshots / create_snapshot / delete_snapshot / rollback_snapshot — 本地快照
• create_b2_snapshot — 云端快照（Backblaze B2）
• schedule_snapshot / cancel_scheduled_snapshot — 定时快照
• get_snapshot_usage — 查看配额
• list_backups / create_backup / restore_backup — 自动和手动备份

域名

• search_domain — 检查可用性和价格
• register_domain — 使用 WHOIS 信息注册（支持 .ca、.com、.net 等）
• list_domains / domain_detail — 管理已拥有的域名

SSH 与日志

• get_ssh_info / add_ssh_key — VPS 方案的 SSH 访问
• get_logs — 获取错误、访问和 PHP 日志

模块

• list_modules / toggle_module — 启用或禁用 AI 模块（SEO、翻译、内容）

账户与账单

• update_account / delete_account — 个人资料管理
• list_subscriptions / get_billing_portal — 账单信息和 Stripe 门户
• rotate_key — 轮换 API 密钥
• get_metrics — 流量和性能指标

资源

该服务提供 5 个 MCP 资源，用于结构化参考数据：

URI	描述
borealhost://api/errors	错误代码、HTTP 状态和恢复指南
borealhost://api/scopes	API 密钥权限范围层级和工具要求
borealhost://api/enums	有效的枚举值（结账状态、DNS 类型、日志类型等）
borealhost://api/response-format	API 响应封装文档
borealhost://plans	实时方案目录及当前价格

提示词

提供 5 个常见操作的引导式工作流提示词：

• purchase_hosting — 逐步完成方案购买流程
• setup_site — 购买后的站点配置
• manage_dns — 常见 DNS 操作
• register_domain — 附带 WHOIS 检查清单的域名注册
• claim_site_key — 质询-响应密钥认领

示例工作流

Agent: register()
→ {"api_key": "bh_...", "scopes": ["read", "write"]}

Agent: list_plans()
→ [{"slug": "starter", "price_monthly": 9.99, ...}, ...]

Agent: create_checkout("bh_site_starter_monthly")
→ {"checkout_id": "chk_...", "checkout_secret": "..."}

Agent: update_checkout("chk_...", requested_slug="my-new-site")
→ {"status": "ready"}

Agent: complete_checkout("chk_...")
→ {"payment_url": "https://borealhost.ai/pay/chk_.../?s=...",
   "confirmation_url": "https://borealhost.ai/pay/chk_.../confirmation/?s=..."}
  # show payment_url to the human; paying provisions the site

Agent: get_checkout_status("chk_...")  # poll until completed
→ {"status": "completed", "api_key": "bh_...",   # shown ONCE
   "site": {"slug": "my-new-site", "status": "active"}}

Agent: get_site_status("my-new-site")
→ {"status": "active", "url": "https://my-new-site.borealhost.ai"}

Authentication

• API key format: bh_ + 48 hex characters
• Scopes: read (view) → write (modify) → admin (delete/scale)
• No auth needed for: list_plans, create_checkout, update_checkout, complete_checkout, get_checkout_status
• Keys are shown once on creation — store immediately

Requirements

• Python 3.10+
• Dependencies: mcp[cli]>=1.2.0, httpx>=0.27.0

Links

• BorealHost.ai
• API Documentation
• Full LLM Reference

License

Proprietary. Copyright 2025-2026 BorealHost.ai. All rights reserved.