LWS

lws-mcp

English · Français

面向 LWS 客户端 API 的 MCP 服务。通过 Claude、Cursor 或任何 MCP 客户端管理域名、DNS 区域、主机服务和账户：

“将 Stripe 提供给我的 CNAME 记录添加到 example.fr，然后告诉我何时生效。”

它涵盖完整的 LWS 客户端 API（29 个端点），还提供传播检查功能，可对比你的 LWS 区域、其名称服务器和三个公共解析器。

社区项目，与 LWS 无关联，也未获其认可。

工具

¹ 付费操作：默认关闭，除非设置 LWS_ENABLE_PURCHASES=true。² 仅在测试模式下可用。

DNS 记录名称可以写成完整形式（_dmarc.example.fr）：它们会被缩短为 LWS 区域所需的形式（_dmarc、@）。

安全性

可访问 DNS 的助手可能会导致网站或邮箱无法访问；可访问购买功能的助手则可能会花费资金。因此：

• 默认关闭购买功能。 只有设置 LWS_ENABLE_PURCHASES=true 后，才会提供 buy_hosting 和 renew_hosting。
• 只读模式。 LWS_READ_ONLY=true 会移除所有会进行修改的工具。
• 向客户端提供提示。 每个工具都会声明其操作是读取、写入还是销毁（工具注解），因此客户端可以在执行前征求确认。
• 测试环境。 LWS_TEST_MODE=true 会将所有请求发送到 LWS 沙盒。
• 密钥留在本地。 密钥只会发送到 api.lws.net，不会被记录或返回给模型。

要求

• LWS 账户及其 API 密钥：LWS 控制面板 → 你的账户编号（LWS-XXXXXX，右上角）→ Api LWS → Clé API en mode PRODUCTION → voir。LWS 指南。
• 运行服务的机器的公网 IP 地址，必须在同一个 Api LWS 页面中获准。否则每次调用都会失败，并显示 bad source <your IP>。
• uv（它会为你获取 Python 和服务）。

安装

每个客户端都运行相同的命令 uvx lws-mcp，并在其环境中设置 LWS_LOGIN 和 LWS_API_KEY（可选设置请参阅配置）。

按钮会将 LWS_LOGIN 和 LWS_API_KEY 留空：安装后请填写这两项。

claude mcp add lws \
  -e LWS_LOGIN=123456 \
  -e LWS_API_KEY=your-api-key \
  -- uvx lws-mcp

codex mcp add lws \
  --env LWS_LOGIN=123456 \
  --env LWS_API_KEY=your-api-key \
  -- uvx lws-mcp

[mcp_servers.lws]
command = "uvx"
args = ["lws-mcp"]
env = { LWS_LOGIN = "123456", LWS_API_KEY = "your-api-key" }

{
  "mcpServers": {
    "lws": {
      "command": "uvx",
      "args": [
        "lws-mcp"
      ],
      "env": {
        "LWS_LOGIN": "123456",
        "LWS_API_KEY": "your-api-key"
      }
    }
  }
}

code --add-mcp '{"name":"lws","command":"uvx","args":["lws-mcp"],"env":{"LWS_LOGIN":"123456","LWS_API_KEY":"your-api-key"}}'

{
  "servers": {
    "lws": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "lws-mcp"
      ],
      "env": {
        "LWS_LOGIN": "123456",
        "LWS_API_KEY": "your-api-key"
      }
    }
  }
}

{
  "mcpServers": {
    "lws": {
      "command": "uvx",
      "args": [
        "lws-mcp"
      ],
      "env": {
        "LWS_LOGIN": "123456",
        "LWS_API_KEY": "your-api-key"
      }
    }
  }
}

配置

你需要了解的信息

• 延迟执行的操作。 名称服务器更改、转移保护、授权码、购买和续费都会在后台处理。请使用 list_pending_requests 跟踪这些操作。
• 传播。 DNS 更改可能需要几分钟到几小时才能在各处生效：每个解析器都会保留旧答案，直到其 TTL 到期。check_dns_propagation 会比较 LWS 区域中保存的记录、域名名称服务器返回的答案（无缓存），以及 Cloudflare、Google 和 Quad9 返回的答案，然后告知旧答案可能持续多久。有些网络会阻止直接向名称服务器发送 DNS 查询；该工具会通过 HTTPS 向解析器查询，因此这部分始终可用。
• 记录 ID 会变化。 更新记录时，LWS 会用新的 ID 替换原记录。add_dns_record 和 update_dns_record 会返回当前 ID。
• 速率限制。 连续请求约 15 次后，LWS 会以 Invalid input (rate limit) 拒绝后续请求：请等待一分钟后重试。
• 允许的 TTL。 900、1800、3600、7200、21600、43200 或 86400 秒。

开发

git clone https://github.com/NKSTUD/lws-mcp && cd lws-mcp
uv sync
uv run pytest
uv run ruff check . && uv run ruff format --check .

使用 MCP Inspector 对你的账户进行测试，并将凭据放在本地 .env 文件中（请参阅 .env.example）：

npx @modelcontextprotocol/inspector uv run --env-file .env lws-mcp

请参阅 CONTRIBUTING.md，了解如何添加工具或修复错误。

许可证

MIT