ServBay MCP Server 소개

ServBay MCP Server는 ServBay에 내장된 Model Context Protocol(MCP) 기반 서버입니다. 이를 통해 Claude, Cursor, VS Code와 같이 MCP를 지원하는 AI 도구가 사용자의 로컬 ServBay 개발 환경을 직접 '보고' '조작'할 수 있습니다. 서비스 상태 조회, 웹사이트와 도메인 관리, 데이터베이스 조작, 인증서 발급, 백업 생성, 로그 및 시스템 지표 읽기 등 다양한 기능을 대화 창과 ServBay 인터페이스를 오가지 않고도 사용할 수 있습니다.

이 문서에서는 ServBay MCP Server가 무엇이며, 어떤 일을 할 수 있는지 소개합니다. 접속 방법과 AI 규칙은 아래 문서를 참고하세요:

• AI 클라이언트 연동(IDE Integration) — MCP를 Claude Code / Cursor / VS Code 등과 원클릭 통합
• AI 규칙(AI Rule) — AI가 ServBay MCP를 올바르고 안전하게 활용하도록 가이드

MCP란 무엇인가요?

Model Context Protocol(MCP)은 AI 애플리케이션이 외부 도구 및 데이터 소스와 표준 방식으로 연결할 수 있도록 만든 오픈 프로토콜입니다. ServBay는 자체 환경 관리 기능을 MCP Server로 패키징하여, MCP를 지원하는 AI 클라이언트라면 누구나 ServBay의 기능을 호출할 수 있도록 했습니다.

MCP Server는 로컬 프로세스(표준 입출력 전송)로 ServBay와 함께 배포되며, AI 클라이언트가 필요 시 자동으로 실행하므로 별도의 설치나 배포가 필요하지 않습니다.

ServBay MCP로 할 수 있는 일

ServBay MCP Server가 제공하는 기능은 ServBay의 핵심 관리 영역을 모두 포괄합니다:

• 환경 및 구독 — 환경 정보 확인, 구독/플랜 상태 확인, 진단 실행
• 시스템 정보 및 지표 — CPU, 메모리, 디스크, 네트워크 등 시스템 정보와 실시간 지표 제공(시스템 정보 및 지표 참고)
• 서비스 관리 — 서비스 목록 확인, 상태 조회, PHP, Node.js, MySQL, MariaDB, PostgreSQL, Redis, Memcached, Mailpit, MinIO, Ollama 등 시작/중지/재시작
• 서비스 설정 및 로그 — 서비스 설정 읽기/쓰기, 서비스 로그 확인
• 웹사이트 및 도메인 — 로컬 웹사이트 목록/조회/생성/수정/삭제, 사이트 활성화 및 비활성화, hosts 레코드 및 dnsmasq 도메인 관리
• 포트 — 포트 사용 현황 확인
• TLS/HTTPS 인증서 — 인증서 목록 확인, 발급, 재발급, 삭제
• 데이터베이스 — 데이터베이스 목록/생성, 데이터베이스 비밀번호 설정/재설정
• 패키지 관리 — 설치/가능한 패키지 목록 확인, 설치/제거/활성화/비활성화, 버전 변경
• Ollama 모델 — 로컬 Ollama 모델 목록 확인/삭제
• 백업 — 백업 목록, 생성, 복원, 삭제, 백업 일정 확인

이런 기능을 활용하면 "PHP 8.3을 시작해서 새 사이트 하나 만들어줘", "이 도메인에 인증서 발급해줘", "MySQL 에러 로그 좀 보여줘"와 같이 AI에게 요청만 하면, AI가 MCP를 통해 ServBay에 명령을 내리고 작업을 대신 수행합니다.

보안 안내

• MCP Server는 로컬에서만 동작하며, 표준 입출력을 통해 로컬 AI 클라이언트와 통신합니다.
• 쓰기 또는 파괴적 작업(예: 사이트 삭제, 데이터베이스 비밀번호 초기화, 백업 복원)의 경우, AI가 어떤 변경을 실행할지 먼저 설명하고 사용자의 확인 후 실행하도록 권장합니다.
• 대화창에 키, 토큰, DNS API Key, 데이터베이스 비밀번호 혹은 프라이빗 키 등 민감 정보를 붙여넣지 마세요—ServBay MCP는 이러한 민감 정보를 수동으로 입력할 필요 없이 동작하도록 설계되었습니다.
• AI 규칙과 함께 사용하면, AI가 더욱 체계적이고 안전하게 ServBay MCP를 활용할 수 있습니다.

사전 준비사항

• ServBay가 macOS 또는 Windows에 설치되어 실행 중이어야 합니다.
• MCP를 지원하는 AI 클라이언트(예: Claude Code, Cursor, VS Code + Copilot, Claude Desktop, Codex 등)를 보유하고 있어야 합니다.

다음 단계

• AI 클라이언트 연동 문서를 참고하여 ServBay MCP를 손쉽게 AI 툴에 통합하세요.
• AI 규칙을 설치해 AI가 ServBay MCP를 더 우선적이고 올바르게 사용하도록 안내하세요.

요약

ServBay MCP Server는 ServBay의 환경 관리 기능을 AI 도구에 공개하여, '자연어로 로컬 개발 환경 관리'가 가능하게 만듭니다. ServBay와 함께 바로 사용할 수 있고, 추가 배포 과정이 필요 없는 AI-native 개발을 위한 핵심 솔루션입니다.