websupport-mcp

Websupport REST API v1 + v2를 래핑하는 MCP 서버(TypeScript, ESM, stdio)입니다. DNS, FTP, 호스팅, 데이터베이스, 메일함, VPS 및 인보이스를 서명된 HMAC-SHA1 인증과 함께 MCP 도구로 노출합니다.

상태: 개발 중. 50개 도구가 모두 구현되었고 서버가 실행됩니다. 남은 작업은 실제 리소스를 보유한 계정에 대한 검증, 패키징 및 릴리스입니다. 진행 상황은 IMPLEMENTATION_PLAN.md를 참조하세요.

위험 등급

도구는 세 가지 등급으로 등록되며, 등급은 등록을 제어합니다. 읽기 전용 배포는 tools/list에서 쓰기 도구를 전혀 볼 수 없으므로 클라이언트 컨텍스트를 소모하지 않으며 어떠한 접근 가능성도 제공하지 않습니다.

도구가 단순히 쓰기 때문에가 아니라, 값싸게 재생성할 수 없는 상태를 파괴할 때 destructive로 분류됩니다. 정상적인 VPS 재부팅은 write이고, 강제 전원 차단은 진행 중인 쓰기를 손상시킬 수 있으므로 destructive입니다. 스냅샷 생성은 write이고, 복원은 그 이후의 모든 것을 폐기하므로 destructive입니다.

두 옵트인은 독립적입니다. 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는 두 개의 활성 LTS 라인인 22와 24를 다루며 각각에서 번들을 빌드하고 스모크 테스트합니다.

빌드에는 npm >= 11도 필요합니다. npm 10은 번들러의 의존성 트리를 해석하지 못하고 도움이 되지 않는 Cannot read properties of null (reading 'edgesOut') 오류로 실패합니다. 이 오류가 발생하면 저장소를 디버깅하는 대신 npm을 업그레이드하세요.

보안

이 서버가 보유한 자격 증명은 Websupport 계정에 대한 완전한 제어 권한을 부여합니다 — 읽기 전용 API 쌍은 없습니다. SECURITY.md는 자격 증명 처리 방법, 민감한 데이터를 반환하는 도구, 취약점을 비공개로 신고하는 방법을 다룹니다.

기여

CONTRIBUTING.md를 참조하세요. 리뷰가 아닌 테스트로 강제되는 두 가지 경계에 유의하세요: 주문 또는 결제 엔드포인트 금지, 모든 파괴적 도구는 confirm: true를 선언해야 함.

라이선스

MIT — LICENSE 참조.