inwx mcp
MCP服务器 INWX 域注册商-第一个具有真正注册商集成的MCP服务器。
警告 此工具执行真实的注册器操作。在 live 模式, 实际成本 将产生。始终先在OTE沙箱中测试!特性
与仅提供只读操作(可用性检查、WHOIS查找)的其他域MCP服务器不同, inwx-mcp 提供 完全注册器集成:
- 域管理:注册、续订、转移和删除域
- DNS管理:创建、更新和删除DNS记录
- 联系人管理:管理WHOIS联系人句柄
- 账户信息:检查余额和账户详细信息
安装
通过npx(推荐)
npx inwx-mcp通过npm
npm install -g inwx-mcp
inwx-mcp来源
git clone https://github.com/your-username/inwx-mcp.git
cd inwx-mcp
bun install
bun run src/index.ts配置
环境变量
# Required
INWX_USERNAME=your-username
INWX_PASSWORD=your-password
# Optional
INWX_ENVIRONMENT=ote # "ote" (default) or "live"
INWX_SHARED_SECRET=secret # Only if 2FA is enabled重要:OTE(沙盒)和实时使用 不同的说法! - 注意:在以下网址注册https://ote.inwx.de(免费测试) - 直播:注册https://www.inwx.de(真钱!)
MCP客户端配置
此服务器可与任何兼容MCP的客户端(Claude Desktop、Cursor、Windsurf、OpenAI Codex等)配合使用。请参阅 MCP官方文件 有关特定于客户端的设置说明。
配置示例:
{
"mcpServers": {
"inwx": {
"command": "npx",
"args": ["-y", "inwx-mcp"],
"env": {
"INWX_USERNAME": "your-username",
"INWX_PASSWORD": "your-password",
"INWX_ENVIRONMENT": "ote"
}
}
}
}可用工具
域名工具
| 工具 | 说明 |
|---|---|
domain_check | 检查域可用性 |
domain_list | 列出您帐户中的所有域 |
domain_info | 获取域详细信息 |
domain_create | 注册新域名 |
domain_renew | 续订域名注册 |
domain_transfer | 将域转移到INWX |
domain_delete | 计划删除域 |
DNS工具
| 工具 | 说明 |
|---|---|
dns_zone_list | 列出所有DNS区域 |
dns_zone_create | 为域创建DNS区域 |
dns_list | 列出DNS记录 |
dns_create | 创建DNS记录 |
dns_update | 更新DNS记录 |
dns_delete | 删除DNS记录 |
联系工具
| 工具 | 说明 |
|---|---|
contact_list | 列出联系人句柄 |
contact_info | 获取联系方式 |
contact_create | 创建联系人句柄 |
contact_update | 更新联系人句柄 |
contact_delete | 删除联系人句柄 |
帐户工具
| 工具 | 说明 |
|---|---|
account_info | 获取账户余额和信息 |
用法示例
注册域名
1. Check availability: domain_check(domain: "example.de")
2. Create contact: contact_create(name: "John Doe", ...)
3. Register: domain_create(domain: "example.de", registrant: 123, ...)
4. Create DNS zone: dns_zone_create(domain: "example.de")
5. Add DNS record: dns_create(domain: "example.de", type: "A", name: "@", content: "1.2.3.4")重要提示
- 域名服务器:域名注册至少需要2个域名服务器。使用INWX名称服务器:
["ns.inwx.de", "ns2.inwx.de", "ns3.inwx.eu"] - DNS区域:注册域后,必须先创建DNS区域,然后才能添加记录
- 联系人ID:域名注册需要4个联系人角色(注册人、管理员、技术人员、账单)-它们都可以是相同的ID
提示
服务器包括常见工作流的有用提示:
register-domain-注册域名的分步指南transfer-domain-将域转移到INWX的指南manage-dns-DNS记录管理指南
发展
设置
# Clone the repo
git clone https://github.com/your-username/inwx-mcp.git
cd inwx-mcp
# Install dependencies
bun install
# Copy env template
cp .env.example .env
# Edit .env with your OTE credentials
# Run tests
bun test测试
在INWX OTE(沙盒)环境中运行测试:
# Unit tests (no credentials needed)
bun test tests/schemas.test.ts
# Integration tests (requires OTE credentials)
bun test tests/integration.test.ts
# Full lifecycle tests
bun test tests/lifecycle.test.ts # .de domain
bun test tests/lifecycle-com.test.ts # .com domain
# All tests
bun test项目结构
inwx-mcp/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── client/
│ │ └── inwx.ts # INWX API client wrapper
│ ├── tools/
│ │ ├── domain.ts # Domain tools
│ │ ├── dns.ts # DNS tools
│ │ ├── contact.ts # Contact tools
│ │ └── account.ts # Account tools
│ ├── types/
│ │ └── index.ts # TypeScript types & Zod schemas
│ └── prompts.ts # MCP prompts
├── tests/
│ ├── schemas.test.ts # Schema validation tests
│ ├── integration.test.ts
│ ├── lifecycle.test.ts
│ └── lifecycle-com.test.ts
└── ...API
免责声明
本软件按“原样”提供,不提供任何形式的保修。作者不对因使用本软件而产生的任何费用、损害或损失负责。
在生产中使用之前:
- 在OTE沙箱中进行彻底测试
- 了解INWX定价和条款
- 确保您的凭据安全
- 监控您的账户余额
许可证
麻省理工学院-见 许可证
贡献
欢迎投稿!请随时提交拉取请求。
