1패널 MCP 서버

1Panel에 자동으로 웹사이트를 배포하기 위한 MCP(Model Context Protocol) 서버입니다.

[!중요] 현재 이 프로젝트는 실험적 프로젝트이므로 직접 사용할 수 없다는 의미는 아닙니다.

비디오 데모

https://www.bilibili.com/video/BV1SjQRY3EmM/

Related MCP server: Playwright MCP

특징

• 1Panel 서버에 웹사이트 배포를 자동화합니다.

• 아직 존재하지 않는 웹사이트를 생성합니다.

• 1Panel에 정적 웹사이트 파일을 업로드합니다.

• MCP 표준 프로토콜과 완벽하게 호환됩니다.

용법

커서 IDE에서 MCP 구성

이 서버를 Cursor IDE와 함께 사용하려면 다음 MCP 구성을 추가하세요.

1. 커서 열기

2. .cursor/mcp.json 생성합니다.

지엑스피1

MCP를 사용하여 웹사이트 배포

Cursor에서 AI 채팅에 다음 명령을 사용하여 웹사이트를 배포할 수 있습니다.

또는 다음 형식을 사용할 수 있습니다.

API 참조

MCP 도구: deploy_website

1Panel에 웹사이트를 배포합니다.

매개변수:

• domain (필수): 웹사이트 도메인

• buildDir (선택 사항): 빌드 디렉토리 경로

응답:

구현 세부 사항

배포 프로세스

1. 빌드 디렉토리 확인 : 지정된 빌드 디렉토리가 있는지 확인합니다.

2. 웹사이트 생성 : 1Panel API를 통해 새로운 정적 웹사이트가 존재하지 않을 경우 생성합니다.

3. 파일 업로드 : 빌드 디렉토리의 모든 파일을 웹사이트로 업로드합니다.

4. 통계 : 업로드 프로세스에 대한 자세한 통계를 반환합니다.

문제 해결

배포 문제가 발생하면 다음을 확인하세요.

1. API 키가 유효하고 충분한 권한이 있는지 확인하세요.

2. 웹사이트 디렉토리가 존재하고 쓰기 권한이 있는지 확인하세요.

3. 더 자세한 오류 정보는 1Panel 서버 로그를 확인하세요.

4. 파일 업로드가 실패하는 경우 파일 권한 또는 형식 문제가 원인일 수 있습니다.