{
  "markdown": "# 阿里云域名 MCP 服务器\n\n[![npm version](https://img.shields.io/npm/v/mcp-aliyun-domain.svg)](https://www.npmjs.com/package/mcp-aliyun-domain)\n[![npm downloads](https://img.shields.io/npm/dm/mcp-aliyun-domain.svg)](https://www.npmjs.com/package/mcp-aliyun-domain)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io/servers/io.github.lzx3in/mcp-aliyun-domain)\n\n> **免责声明：** 本项目为第三方社区开源工具，与阿里巴巴集团及阿里云无任何关联，非阿里云官方产品。阿里云（Aliyun）及相关标识是阿里巴巴集团的商标。使用本项目前请自行评估风险。\n\nMCP 服务器，集成阿里云域名 API，支持从 AI 助手直接查询域名可用性、获取域名详情、管理域名列表和创建域名注册订单。\n\n## 功能工具\n\n| 工具 | 描述 |\n|------|------|\n| `check_domain` | 查询域名是否可注册 |\n| `query_domain_detail` | 查询域名详细信息 |\n| `list_domains` | 列出阿里云账号下的域名列表 |\n| `create_order` | 创建域名注册订单 |\n\n## 安装\n\n使用 pnpm（推荐）：\n\n```bash\npnpm install -g mcp-aliyun-domain\n```\n\n使用 npm：\n\n```bash\nnpm install -g mcp-aliyun-domain\n```\n\n或者使用 pnpm dlx / npx 直接运行：\n\n```bash\npnpm dlx mcp-aliyun-domain\n# 或\nnpx mcp-aliyun-domain\n```\n\n## 配置\n\n### 凭证配置\n\n**方式一：`.env` 文件（推荐）**\n\n复制示例文件并填写您的密钥：\n\n```bash\ncp .env.example .env\n# 编辑 .env 填入您的 AccessKey\n```\n\n**方式二：环境变量**\n\n```bash\nexport ALIBABA_CLOUD_ACCESS_KEY_ID=\"your-access-key-id\"\nexport ALIBABA_CLOUD_ACCESS_KEY_SECRET=\"your-access-key-secret\"\n```\n\n**方式三：自动发现**\n\n当您未配置任何凭证时，服务器会自动尝试以下来源（按顺序）：\n1. 阿里云 CLI 配置（`~/.aliyun/config.json`）\n2. 阿里云凭证文件（`~/.alibabacloud/credentials`）\n3. ECS RAM 角色（仅在阿里云 ECS 上运行时可用）\n\n适合已在本地配置过阿里云 CLI 或运行在阿里云 ECS 上的用户。\n\n### OpenClaw\n\n**方式一：CLI 命令（推荐）**\n\n```bash\nopenclaw mcp add aliyun-domain \\\n  --command npx \\\n  --arg -y \\\n  --arg mcp-aliyun-domain \\\n  --env ALIBABA_CLOUD_ACCESS_KEY_ID=your-key \\\n  --env ALIBABA_CLOUD_ACCESS_KEY_SECRET=your-secret\n```\n\n添加后验证：\n\n```bash\nopenclaw mcp probe aliyun-domain   # 应显示 4 tools\nopenclaw mcp reload                # 通知网关加载新配置\n```\n\n**方式二：手动编辑配置文件**\n\n在 `~/.openclaw/openclaw.json` 的 `mcp.servers` 中添加：\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"aliyun-domain\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"mcp-aliyun-domain\"],\n        \"env\": {\n          \"ALIBABA_CLOUD_ACCESS_KEY_ID\": \"your-key\",\n          \"ALIBABA_CLOUD_ACCESS_KEY_SECRET\": \"your-secret\"\n        }\n      }\n    }\n  }\n}\n```\n\n### OpenCode\n\n在 `~/.config/opencode/opencode.jsonc` 中的 `mcp` 字段添加：\n\n```jsonc\n{\n  \"mcp\": {\n    \"aliyun-domain\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"mcp-aliyun-domain\"],\n      \"environment\": {\n        \"ALIBABA_CLOUD_ACCESS_KEY_ID\": \"your-key\",\n        \"ALIBABA_CLOUD_ACCESS_KEY_SECRET\": \"your-secret\"\n      }\n    }\n  }\n}\n```\n\n### Qoder / Qoder CN\n\n在 Qoder MCP 配置文件中添加（Qoder CN 路径为 `~/.config/QoderCN/SharedClientCache/mcp.json`）：\n\n```json\n{\n  \"mcpServers\": {\n    \"aliyun-domain\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-aliyun-domain\"],\n      \"env\": {\n        \"ALIBABA_CLOUD_ACCESS_KEY_ID\": \"your-key\",\n        \"ALIBABA_CLOUD_ACCESS_KEY_SECRET\": \"your-secret\"\n      }\n    }\n  }\n}\n```\n\n## 使用示例\n\n### 1. 查询域名可用性\n\n**输入：** 帮我查询 `myawesomeapp.com` 是否可以注册\n\n**输出：**\n```\n域名: myawesomeapp.com\n可用性: 可注册 (code: 1)\n\n✅ 该域名可以注册！\n建议使用 create_order 工具创建注册订单\n```\n\n**输入：** 查询 `google.com` 能否注册\n\n**输出：**\n```\n域名: google.com\n可用性: 不可注册 (code: 0)\n\n不可注册原因: Domain exists\n```\n\n### 2. 查询域名详情\n\n**输入：** 查询我的域名 `example.com` 的详细信息\n\n**输出：**\n```\n域名详情: example.com\n========================================\n注册者: 张三\n组织: 某某科技有限公司\n邮箱: admin@example.com\n到期时间: 2026-12-31 23:59:59\n注册时间: 2020-01-15 10:30:00\n状态: 正常\n域名验证: SUCCEED\n实名认证: SUCCEED\n邮箱验证: 已验证\nWHOIS 保护: 关闭\nDNS1: ns1.aliyun.com\nDNS2: ns2.aliyun.com\n实例ID: domain-cn-abc123xyz\n域名类型: cTLD\n距离到期: 1825 天\n\n管理状态:\n  自动续费: 开启\n  转移锁: 关闭\n  更新锁: 关闭\n  资源组: rg-acfm363qrffqy6q\n```\n\n### 3. 列出域名\n\n**输入：** 列出我账户下的所有域名\n\n**输出：**\n```\n域名列表 (共 5 个，第 1 页):\n==================================================\n• mycompany.com [到期: 2026-08-15] (状态: 正常) [审核: SUCCEED] [自动续费: 开启]\n• mycompany.cn [到期: 2026-10-20] (状态: 正常) [审核: SUCCEED] [自动续费: 开启]\n• mycompany.net [到期: 2026-05-30] (状态: 正常) [审核: SUCCEED] [自动续费: 关闭]\n• testdomain.com [到期: 2025-12-01] (状态: 需要续费) [审核: FAILED] [自动续费: 关闭]\n• demo-app.cn [到期: 2027-01-10] (状态: 正常) [审核: SUCCEED] [自动续费: 开启]\n```\n\n### 4. 创建域名注册订单\n\n**输入：** 帮我注册 `newdomain2025.com`，注册 2 年，使用模板 ID 12345\n\n**输出：**\n```\n域名注册任务已提交!\n==============================\n任务编号: 12345678-ABCD-EFGH-1234-567890ABCDEF\n任务状态: 0\n\n⚠️ 请前往阿里云控制台完成支付和实名认证。\n```\n\n**注意事项：** 创建订单前请务必先使用 `check_domain` 确认可注册性\n\n---\n\n## 开发\n\n```bash\ngit clone https://github.com/lzx3in/mcp-aliyun-domain\ncd mcp-aliyun-domain\n\n# 使用 pnpm（推荐）\npnpm install\npnpm dev          # 使用 tsx 运行（开发模式）\npnpm build        # 编译到 dist/ 目录\n\n# 或使用 npm\nnpm install\nnpm run dev       # 使用 tsx 运行（开发模式）\nnpm run build     # 编译到 dist/ 目录\n```\n\n## 发布\n\n项目使用 GitHub Actions 自动发布到 NPM 和 MCP Registry。推送 `v*` 标签即可触发自动发布流程：\n\n```bash\n# 1. 更新版本号（package.json 和 server.json 需保持一致）\n# 2. 提交代码\ngit add -A && git commit -m \"chore: bump version to x.y.z\"\n# 3. 打标签并推送\ngit tag vx.y.z && git push origin main --tags\n```\n\n**前置条件：** 需在 npmjs.com 的包设置中配置 **Trusted Publishers**（推荐，无需存储 token）：\n- Provider: GitHub Actions\n- Organization: `lzx3in`\n- Repository: `mcp-aliyun-domain`\n- Workflow filename: `publish.yml`\n\n## 许可证\n\nMIT\n",
  "bytes": 5119,
  "sha": "0de0c3641e1515291fe999ce385abd89cda86a0c2a34dad4a877f8a3d3cefe91",
  "repo_slug": "lzx3in/mcp-aliyun-domain",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_lzx3in_mcp_aliyun_domain_c56af52f/readme"
}