[영어] | [중국어(간체)]

1패널 MCP 서버

1Panel MCP 서버는 1Panel 용 MCP(Model Context Protocol) 서버를 구현한 것입니다.

설치 방법

방법 1: 릴리스 페이지에서 다운로드(권장)

릴리스 페이지를 방문하여 귀하의 시스템에 맞는 실행 파일을 다운로드하세요.
설치 예(amd64용):

지엑스피1

방법 2: 소스에서 빌드

Go 1.23 이상이 로컬에 설치되어 있는지 확인하세요. 그런 다음 다음을 실행하세요.

저장소를 복제합니다.

git clone https://github.com/1Panel-dev/mcp-1panel.git cd mcp-1panel

실행 파일을 빌드합니다.

make build

./build/mcp-1panel을 시스템의 PATH에 포함된 디렉토리로 이동합니다.

방법 3: go install을 통해 설치

Go 1.23 이상이 로컬에 설치되어 있는지 확인하세요. 그런 다음 다음을 실행하세요.

go install github.com/1Panel-dev/mcp-1panel@latest

방법 4: Docker를 통해 설치

Docker가 컴퓨터에 올바르게 설치되고 구성되었는지 확인하세요.

공식 이미지는 다음 아키텍처를 지원합니다.

amd64
arm64
팔/v7
s390x
ppc64le

Related MCP server: MCP Server

용법

1패널 MCP 서버는 stdio 와 sse 두 가지 실행 모드를 지원합니다.

stdio 모드

로컬 바이너리 사용

Cursor 또는 Windsurf의 구성 파일에 다음을 추가합니다.

{ "mcpServers": { "mcp-1panel": { "command": "mcp-1panel", "env": { "PANEL_ACCESS_TOKEN": "<your 1Panel access token>", "PANEL_HOST": "such as http://localhost:8080" } } } }

Docker에서 실행

{ "mcpServers": { "mcp-1panel": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "PANEL_HOST", "-e", "PANEL_ACCESS_TOKEN", "1panel/1panel-mcp-server" ], "env": { "PANEL_HOST": "such as http://localhost:8080", "PANEL_ACCESS_TOKEN": "<your 1Panel access token>" } } } }

sse 모드

MCP 서버를 시작합니다.

mcp-1panel -host http://localhost:8080 -token <your 1Panel access token> -transport sse -addr http://localhost:8000

Cursor 또는 Windsurf에서 구성:

{ "mcpServers": { "mcp-1panel": { "url": "http://localhost:8000/sse" } } }

명령줄 옵션

-token : 1패널 액세스 토큰
-host : 1패널 접속 주소
-transport : 전송 유형(stdio 또는 sse, 기본값: stdio)
-addr : SSE 서버 시작 주소(기본값: http://localhost:8000 )

사용 가능한 도구

서버는 1Panel과 상호 작용하기 위한 다양한 도구를 제공합니다.

도구	범주	설명
대시보드 정보 가져오기	체계	대시보드 상태 목록
시스템 정보 가져오기	체계	시스템 정보 가져오기
웹사이트 목록	웹사이트	모든 웹사이트 나열
웹사이트 생성	웹사이트	웹사이트를 만드세요
목록_ssls	자격증	모든 인증서 나열
create_ssl	자격증	인증서 생성
설치된 앱 목록	애플리케이션	설치된 앱 목록
install_openresty	애플리케이션	OpenResty 설치
MySQL 설치	애플리케이션	MySQL 설치
목록_데이터베이스	데이터 베이스	모든 데이터베이스 나열
데이터베이스 생성	데이터 베이스	데이터베이스 생성