특징

• 패널 시스템 정보 및 네트워크 상태를 얻기
• PHP 웹 사이트 목록
• 새로운 PHP 웹 사이트 만들기
• Query MySQL 데이터베이스 목록
• Docker 컨테이너 관리
• 컨테이너 목록보기
• 컨테이너 상세보기
• Docker 이미지 관리
• 지역 이미지 목록 보기
• 이메일 관리
• 이메일 계정 추가
• 이메일 목록보기
• 패널 공개 설정 정보 얻기
• 개발 중 더 많은 기능 …

요구 사항

• 이동 1.18+
• aaPanel API 액세스
• aaPanel API 토큰

설치

소스 코드에서

직접 다운로드

또한 릴리스 페이지에서 사전 컴파일 된 바이너리를 다운로드 할 수 있습니다.

구성

환경 변수

환경 변수를 통해 프로그램을 구성:

커서 구성

Cursor에서 사용할 때 다음 단계를 구성하십시오.

1. 오픈 커서 설정 > 확장 > MCP 도구
2. 새로운 MCP 도구를 추가
3. 뒤에 오는 체재에 있는 윤곽에 채우십시오:

새 기능 추가

1. 해당 모듈 디렉토리에 파일 생성 또는 수정
2. 새로운 도구 상수 및 도구 개체 정의
3. 핸들러 기능 구현
4. main.go의 registerTools 기능에 등록 도구

빌드 및 배포

Makefile을 사용하여 빌드:

라이센스

aaPanel MCP Interface

Features

• Get panel system information and network status
• Query PHP website list
• Create new PHP website
• Query MySQL database list
• Docker container management
  • View container list
  • View container details
• Docker image management
  • View local image list
• Email management
  • Add email account
  • View email list
• Get panel public configuration information
• More features under development…

Requirements

• Go 1.18+
• aaPanel API access
• aaPanel API token

Installation

From source code

# Clone repository
git clone https://github.com/aaPanel/mcp-server.git
cd mcp_btpanel

# Install dependencies
go mod tidy

# Build project
make build

# Build for Windows
.\build.bat build

Direct download

You can also download pre-compiled binaries from the Releases page .

Configuration

Environment variables

Configure the program through environment variables:

# Set aaPanel address
export BT_BASE_URL="http://your-panel-address:8888"

# Set aaPanel API token
export BT_API_TOKEN="your-api-token"

Cursor configuration

When using in Cursor, configure through the following steps:

1. Open Cursor Settings > Extensions > MCP Tools
2. Add new MCP tool
3. Fill in the configuration in the following format:

{
    "mcpServers": {
        "mcp-aapanel": {
            "command": "C:\\path\\to\\mcp-server.exe",
            "env": {
                "BT_BASE_URL": "http://192.168.xx.xx:8888/",
                "BT_API_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxx"
            }
        }
    }
}

Adding new features

1. Create or modify files in the corresponding module directory
2. Define new tool constants and tool objects
3. Implement handler functions
4. Register tools in the registerTools function in main.go

Build & Deployment

Build using Makefile:

# Build project
make build

# Build Windows version
make build-windows

# Clean build artifacts
make clean

# View more commands
make help

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Welcome to submit issues and feature requests! If you want to contribute, please:

1. Fork this repository
2. Create your feature branch ( git checkout -b feature/amazing-feature )
3. Commit your changes ( git commit -m ‘Add some amazing feature’ )
4. Push to the branch ( git push origin feature/amazing-feature )
5. Open a Pull Request