websupport-mcp

Websupport REST API v1 + v2（DNS、FTP、ホスティング、データベース、メールボックス、VPS、請求書）をラップするMCPサーバー（TypeScript、ESM、stdio）で、署名付きHMAC-SHA1認証付きのMCPツールとして公開します。

ステータス: 開発中。 50個のツールはすべて実装済みで、サーバーは動作します。残っているのは、実際のリソースを所有するアカウントでの検証、パッケージング、リリースです。進捗は IMPLEMENTATION_PLAN.md を参照してください。

リスクティア

ツールは3つのティアで登録され、ティアは登録を制御します。読み取り専用のデプロイでは tools/list に書き込みツールが一切表示されないため、クライアントのコンテキストを消費せず、操作の手掛かりも提供しません。

ツールがdestructiveとされるのは、安価に再作成できない状態を破壊する場合であり、単に書き込むからではありません。グレースフルなVPS再起動はwrite、強制電源再投入はdestructiveです。実行中の書き込みを破損させる可能性があるためです。スナップショット取得はwrite、復元はdestructiveです。それ以降のすべてを破棄するためです。

2つのオプトインは独立しています。WEBSUPPORT_ALLOW_DESTRUCTIVE=1 だけでは書き込みツールは有効になりません。逆も同様です。

安全境界となるのはMCPのelicitationではなく、confirm: true 引数です。プロトコルネゴシエーションはelicitationをサポートするリビジョンよりかなり低いバージョンに落ち着く可能性があり（このサーバーのSDKは現在 2025-11-25 が上限です）、古いクライアントに対して消えてしまうゲートはゲートではありません。

Related MCP server: cpanel-mcp

インストール

まだ公開されていません。ローカルチェックアウトから実行するには:

npm install
npm run build

その後、MCPクライアントから接続します:

Node >= 22 が必要です。

{
  "mcpServers": {
    "websupport": {
      "command": "node",
      "args": ["/absolute/path/to/websupport-mcp/dist/index.js"],
      "env": {
        "WEBSUPPORT_API_KEY": "…",
        "WEBSUPPORT_API_SECRET": "…"
      }
    }
  }
}

認証情報

WebAdmin（セキュリティ → APIキー）で標準APIアクセスペアを生成します。DynDNS専用ペアは /nic/update に対してのみ認証され、それ以外には使用できません。

ローカル開発用に .env.example をコピーしてください。.env はgitignoreされています。

マーケット

Websupportは地域別のteam.blue/Loopiaブランドであるため、APIホストがマーケットを選択します。同じアプリケーションがすべてのホストにサービスを提供しており（GET /v2/docs/openapi.json はすべてのホストでバイト単位で同一）、マーケットの切り替えは設定であり、コードの変更ではありません。

認識されないホストはstderrに警告を出力した上で使用されるため、新しく追加されたマーケットはリリースを待たずに動作します。

ドキュメント

スコープ

注文作成と請求書/注文の支払いエンドポイントは意図的にスコープ外であり、テストによって存在しないことが検証されています。v1のDNSレコードCRUDとv1のFTPアカウントCRUDは上流で非推奨となっており、公開されていません — v2のツールが両方をカバーしています。

開発

npm test              # offline suite
npm run test:network  # live, unauthenticated probes (market hosts + OpenAPI drift)
npm run typecheck
npm run lint
npm run build

ネットワークスイートは意図的に分離されています。Websupportの障害でビルドが失敗してはならないためです。

ツールチェーン

実行またはビルドにはNode >= 22が必要です。Node 20は2026-04-30にサポート終了となり、サポートされていません。CIは現行の2つのLTSライン（22と24）をカバーし、それぞれでバンドルをビルドしてスモークテストします。

ビルドにはnpm >= 11も必要です。npm 10はバンドラーの依存関係ツリーを解決できず、役に立たないエラー Cannot read properties of null (reading 'edgesOut') で失敗します。このエラーに遭遇した場合は、リポジトリをデバッグするのではなくnpmをアップグレードしてください。

セキュリティ

このサーバーが保持する認証情報はWebsupportアカウントの完全な制御を許可します — 読み取り専用のAPIペアは存在しません。SECURITY.md では、認証情報の取り扱い方法、機密データを返すツール、脆弱性の非公開報告方法について説明しています。

コントリビューション

CONTRIBUTING.md を参照してください。レビューではなくテストで強制される2つの境界に注意してください: 注文・支払いエンドポイントを追加しないこと、すべての破壊的ツールは confirm: true を宣言しなければならないこと。

ライセンス

MIT — LICENSE を参照してください。