1Panel MCP Server

by ruibaby
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows for automated website deployment to 1Panel servers, including creating websites if they don't exist, uploading static website files, and providing deployment statistics.

  • Provides video demonstration capabilities, with a specific demo video hosted on Bilibili showcasing the 1Panel deployment functionality.

1패널 MCP 서버

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

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

비디오 데모

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

특징

  • 1Panel 서버에 웹사이트 배포를 자동화합니다.
  • 아직 존재하지 않는 웹사이트를 생성합니다.
  • 1Panel에 정적 웹사이트 파일을 업로드합니다.
  • MCP 표준 프로토콜과 완벽하게 호환됩니다.

설치

지엑스피1

1Panel 서버 정보로 .env 파일을 편집합니다.

PORT=3000 ONEPANEL_BASE_URL=http://your-1panel-ip:port/api/v1 ONEPANEL_API_KEY=your_api_key ONEPANEL_LANGUAGE=zh # Language options: zh (Chinese) or en (English)

용법

서버를 시작합니다

# Start the server npm start # For development with auto-reload npm run dev

커서 IDE에서 MCP 구성

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

  1. 커서 열기
  2. .cursor/mcp.json 생성합니다.
{ "mcpServers": { "Deploy to 1Panel": { "url": "http://localhost:3000/sse" } } }

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

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

Deploy to 1Panel with domain=yourdomain.com

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

Deploy website to 1Panel server, domain: yourdomain.com

API 참조

MCP 도구: deploy_website

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

매개변수:

  • domain (필수): 웹사이트 도메인
  • buildDir (선택 사항): 빌드 디렉토리 경로

응답:

Successfully deployed to 1Panel! Domain: yourdomain.com URL: http://yourdomain.com Upload statistics: - Total files: 25 - Successfully uploaded: 25 - Failed to upload: 0

구현 세부 사항

배포 프로세스

  1. 빌드 디렉토리 확인 : 지정된 빌드 디렉토리가 있는지 확인합니다.
  2. 웹사이트 생성 : 1Panel API를 통해 새로운 정적 웹사이트가 존재하지 않을 경우 생성합니다.
  3. 파일 업로드 : 빌드 디렉토리의 모든 파일을 웹사이트로 업로드합니다.
  4. 통계 : 업로드 프로세스에 대한 자세한 통계를 반환합니다.

문제 해결

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

  1. API 키가 유효하고 충분한 권한이 있는지 확인하세요.
  2. 웹사이트 디렉토리가 존재하고 쓰기 권한이 있는지 확인하세요.
  3. 더 자세한 오류 정보는 1Panel 서버 로그를 확인하세요.
  4. 파일 업로드가 실패하는 경우 파일 권한 또는 형식 문제가 원인일 수 있습니다.
-
security - not tested
F
license - not found
-
quality - not tested

1Panel 서버에 웹사이트 배포를 자동화하기 위해 모델 컨텍스트 프로토콜을 구현하는 실험적 서버로, 사용자가 자연어 명령을 통해 웹사이트를 만들고 정적 파일을 업로드할 수 있도록 합니다.

  1. Video demo
    1. Features
      1. Installation
        1. Usage
          1. Start the server
          2. Configure MCP in Cursor IDE
          3. Use MCP to Deploy Websites
        2. API Reference
          1. MCP Tool: deploy_website
        3. Implementation Details
          1. Deployment Process
        4. Troubleshooting
          ID: oll043mmpu