AiVikings.ai

AiVikings.ai MCP 服务（官方）

这是 AiVikings.ai 的官方 Model Context Protocol 服务。AiVikings.ai 是专为 AI Agent 打造的域名注册商。它支持 ChatGPT、Claude、Cursor 及任何支持 MCP 的 Agent 检查域名是否可用、注册和续费域名，以及管理 DNS、联系人和转移。

无需安装。 AiVikings.ai 在以下地址运行此服务：

https://mcp.aivikings.ai/mcp

设置指南、完整工具参考和定价：aivikings.ai/docs/mcp

连接

你需要拥有 AiVikings.ai 账户。请前往 app.aivikings.ai 创建账户。

此服务使用 OAuth。首次使用时，客户端会打开 AiVikings.ai 页面供你批准连接。目前，该页面会要求你粘贴控制面板中的 API 令牌。

Claude Code

claude mcp add --transport http aivikings https://mcp.aivikings.ai/mcp

Claude（网页版和桌面版）

使用 URL https://mcp.aivikings.ai/mcp 添加自定义连接器。分步指南：Claude 设置。

ChatGPT

使用 URL https://mcp.aivikings.ai/mcp 和 OAuth 身份验证添加连接器。分步指南：ChatGPT 设置。

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "aivikings": {
      "url": "https://mcp.aivikings.ai/mcp"
    }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "aivikings": {
      "type": "http",
      "url": "https://mcp.aivikings.ai/mcp"
    }
  }
}

Cline 和其他 Agent

可代你安装 MCP 服务的 Agent 可参考 llms-install.md。

无人值守的 Agent（LangChain、CrewAI、脚本）

无法使用浏览器的 Agent 无法完成 OAuth。请改为将 AiVikings.ai API 密钥作为 bearer 令牌发送：

{
  "mcpServers": {
    "aivikings": {
      "type": "streamableHttp",
      "url": "https://mcp.aivikings.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AIVIKINGS_API_KEY"
      }
    }
  }
}

可选的 X-Agent-Id 和 X-Agent-Name 标头会在域名审计日志中标注 Agent 执行的操作。

试用

连接后，向助手提出以下请求：

• “cartandcup.com 可以注册吗？注册和续费的费用分别是多少？”
• “为一个天气分析项目构思 20 个名称，并检查哪些 .com 和 .io 域名可用。”
• “使用我的默认联系人注册 nightowlanalytics.com，期限为一年。”
• “将 nightowlanalytics.com 的根域名指向 203.0.113.10，并添加一个 www CNAME 记录。”
• “显示我的域名及其状态和到期日期。”

工具

分组	工具
搜索和定价	check_domain_availability、check_single_domain_availability、get_domain_pricing
注册（会扣除预付余额）	register_domain、renew_domain、domain_transfer
域名管理	get_domain_status、list_domains、update_nameservers、lock_domain、unlock_domain、get_transfer_auth_code、regenerate_transfer_auth_code、get_domain_audit_log
DNS	list_dns_records、add_dns_record、configure_dns_record、update_dns_record、delete_dns_record
联系人	create_contact、get_contact、list_contacts、list_domain_registration_contacts、assign_domain_registration_contact_roles、remove_domain_registration_contact_roles、update_registrant_contact、list_contact_countries、list_contact_states
账户	get_current_user、get_prepaid_balance、get_customer

完整说明和参数：工具参考。

为 Agent 打造

• 预付余额。 注册、续费和转移均从您的预付美元或欧元余额中扣款。调用工具不会扣取银行卡费用。
• 高级域名需要确认。 只有在用户接受报价后，Agent 传入 allow_premium=true，才会注册高级价格域名。
• 安全标注。 每个工具都会标记为只读或写入；破坏性工具（例如 delete_dns_record）也会特别标明，以便客户端在运行前征求确认。
• 审计日志。 每项域名变更都会被记录，并可通过 get_domain_audit_log 读取。
• 纯注册商服务。 购买流程中没有主机托管或电子邮件服务的追加销售。

隐私与安全

此服务是一个轻量适配器。每个请求都会携带您自己的 OAuth 令牌或 API 密钥，由 AiVikings.ai 后端验证，并随每次工具调用转发。适配器不存储凭据，也没有特权备用令牌。内部后端错误详情绝不会传回客户端。

• 隐私政策：aivikings.ai/legal/privacy
• 报告漏洞：请参阅 SECURITY.md

支持

• 问题和想法：GitHub Discussions
• Bug：GitHub Issues
• 电子邮件：[email protected]

---

自托管适配器

大多数用户应连接到上述托管服务。本节介绍如何自行运行适配器，并将其置于 AiVikings.ai 后端之前。

该适配器是一个基于 AiVikings.ai 注册商 REST API 的公共 Streamable HTTP MCP 层。这些工具保留其参数架构、描述和安全标注，并通过 HTTP 调用后端。业务逻辑、身份验证、客户隔离、作用域、提供商访问和审计持久化均由后端负责。

此仓库不包含注册商后端、数据库模型、提供商适配器、前端资源、内部操作手册或生产环境文件。无需访问任一私有仓库即可安装和构建。

本地运行

需要 Python 3.12+，并且需要运行一个提供 /v1/mcp 的 AiVikings.ai 后端。

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e ".[dev]"
cp .env.example .env
# Configure AIVIKINGS_API_BASE_URL to reach the backend.
aivikings-mcp

端点为 http://127.0.0.1:8081/mcp。客户端需发送自己的 AiVikings.ai bearer API 密钥或 OAuth 访问令牌。适配器会通过后端验证令牌，并随每次工具调用转发。没有特权备用令牌。令牌撤销以及客户和作用域检查均由后端权威处理。匿名的 initialize、tools/list 和 ping 发现仍然可用。

GET /healthz 是本地进程健康检查，不是上游就绪状态检查。/.well-known/oauth-protected-resource 会将公共后端公布为 OAuth 授权服务器。AIVIKINGS_API_BASE_URL 是内部 HTTP 地址；对于真实的 OAuth 客户端，AIVIKINGS_PUBLIC_API_BASE_URL 和 AIVIKINGS_MCP_URL 必须可从外部访问。OAuth 令牌签发和签名密钥仍由后端管理。

Docker

docker compose up --build

独立 Compose 的默认设置通过 host.docker.internal 访问后端发布的 8080 端口。请根据您的部署设置上游和公共 URL。如果先复制 .env.example，请将其中的 localhost 上游地址替换为容器内部可访问的地址。不会挂载私有源代码仓库。

测试

pytest

测试使用模拟 HTTP 后端，并在不使用数据库的情况下测试发现、bearer 挑战、每个请求的身份、工具架构和错误净化。后端拒绝请求时会返回 HTTP 状态码形式的工具错误；私有上游响应正文不会暴露给 MCP 客户端。详情请查看后端日志。

可选的 Claude 演示客户端可通过 python -m pip install -e ".[demo]" 安装；在运行 aivikings-demo-agent 之前，请配置客户端侧的 ANTHROPIC_API_KEY 和 AIVIKINGS_MCP_API_KEY。examples/ 中的示例记录仅供参考，内容为历史示例。

许可证

MIT