1Panel MCP Server

1Panel MCP サーバー

1Panel への Web サイトのデプロイを自動化するための、Model Context Protocol（MCP） サーバーです。

重要

現在、このプロジェクトは実験的なものであり、そのまま使用できることを意味するものではありません。

動画デモ

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

機能

• 1Panel サーバーへの Web サイトのデプロイを自動化します
• Web サイトがまだ存在しない場合は作成します
• 静的 Web サイトのファイルを 1Panel にアップロードします
• MCP 標準プロトコルに完全に準拠しています

使用方法

Cursor IDE で MCP を設定する

このサーバーを Cursor IDE で使用するには、以下の MCP 設定を追加します。

1. Cursor を開きます
2. .cursor/mcp.json を作成します

{
  "mcpServers": {
    "1panel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "1panel-mcp"
      ],
      "env": {
        "ONEPANEL_BASE_URL": "<your 1Panel base URL>",
        "ONEPANEL_API_KEY": "<your 1Panel API key>",
        "ONEPANEL_API_VERSION": "v2" // optional, default is v2
      }
    }
  }
}

MCP を使って Web サイトをデプロイする

Cursor では、AI チャットで次のコマンドを使用して Web サイトをデプロイできます。

Deploy to 1Panel with domain=yourdomain.com

または、次の形式を使用できます。

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

API リファレンス

MCP ツール：deploy_website

Web サイトを 1Panel にデプロイします。

パラメーター：

• domain（必須）：Web サイトのドメイン
• 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. Web サイトの作成：存在しない場合は、1Panel API を通じて新しい静的 Web サイトを作成します
3. ファイルのアップロード：ビルドディレクトリ内のすべてのファイルを Web サイトにアップロードします
4. 統計情報：アップロードプロセスの詳細な統計情報を返します

トラブルシューティング

デプロイで問題が発生した場合は、以下を確認してください。

1. API Key が有効で、十分な権限があることを確認します
2. Web サイトのディレクトリが存在し、書き込み権限があることを確認します
3. 詳細なエラー情報について、1Panel サーバーのログを確認します
4. ファイルのアップロードに失敗する場合は、ファイルの権限または形式に問題がある可能性があります