LWS

lws-mcp

English · Français

LWS のクライアント API 用 MCP サーバーです。Claude、Cursor、または任意の MCP クライアントから、ドメイン、DNS ゾーン、ホスティング、アカウントを管理できます。

「Stripe から受け取った CNAME レコードを example.fr に追加して、反映されたら知らせてください。」

LWS Client API 全体（29 エンドポイント）に加え、LWS のゾーン、ネームサーバー、3 つのパブリックリゾルバーを比較する伝播チェック機能も備えています。

LWS とは提携しておらず、LWS による承認も受けていないコミュニティプロジェクトです。

ツール

¹ 有料です。LWS_ENABLE_PURCHASES=true にしない限り無効です。² テストモードでのみ利用できます。

DNS レコード名は、完全な形式（_dmarc.example.fr）で指定できます。LWS のゾーンが想定する形式（_dmarc、@）に短縮されます。

安全性

DNS にアクセスできるアシスタントはサイトやメールボックスを停止させる可能性があり、購入機能にアクセスできる場合は支払いを実行できます。そのため、次の対策を講じています。

• 購入機能はデフォルトで無効です。 buy_hosting と renew_hosting は、LWS_ENABLE_PURCHASES=true の場合にのみ利用できます。
• 読み取り専用モード。 LWS_READ_ONLY=true にすると、変更を加えるすべてのツールが無効になります。
• クライアント向けのヒント。 各ツールは、読み取り、書き込み、破壊的操作のいずれを行うかを宣言します（ツールのアノテーション）。これにより、クライアントは実行前に確認できます。
• テスト環境。 LWS_TEST_MODE=true にすると、すべてのリクエストが LWS サンドボックスに送信されます。
• API キーはローカルに保持されます。 API キーは api.lws.net にのみ送信され、ログに記録されたり、モデルに返されたりすることはありません。

必要条件

• LWS アカウントとその API キー：LWS Panel → アカウント番号（LWS-XXXXXX、右上）→ Api LWS → Clé API en mode PRODUCTION → voir。LWS ガイド。
• サーバーを実行するマシンのパブリック IP アドレス。同じ Api LWS ページで許可する必要があります。許可されていない場合、すべての呼び出しが bad source <your IP> で失敗します。
• uv（Python とサーバーを自動で取得します）。

インストール

すべてのクライアントで、環境変数に LWS_LOGIN と LWS_API_KEY を設定して、同じコマンド uvx lws-mcp を実行します（オプション設定については、設定を参照してください）。

ボタンを使うと、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 を返します。
• レート制限。 LWS は連続したリクエスト（約 15 回）を Invalid input (rate limit) で拒否します。1 分待ってから再試行してください。
• 使用可能な 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 .

ローカルの .env に認証情報を設定して、MCP Inspector でアカウントに対して試してください（.env.example を参照）。

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

ツールの追加やバグの修正については、CONTRIBUTING.md を参照してください。

ライセンス

MIT