##特徴

• パネルシステム情報とネットワークステータスの取得
• PHP のウェブサイトリストの問い合わせ
• 新しいPHPウェブサイトを作成する
• 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