1パネルMCPサーバー

1Panel への Web サイトの自動展開のためのモデル コンテキスト プロトコル (MCP)サーバー。

ビデオデモ

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

Related MCP server: Playwright MCP

特徴

• 1Panelサーバーへのウェブサイトの展開を自動化

• 存在しないウェブサイトを作成する

• 静的ウェブサイトファイルを1Panelにアップロードします

• MCP標準プロトコルと完全に互換性があります

使用法

カーソルIDEでMCPを構成する

このサーバーを Cursor IDE で使用するには、次の MCP 構成を追加します。

1. オープンカーソル

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>"
      }
    }
  }
}

MCPを使用してウェブサイトを展開する

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

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. ファイルのアップロードが失敗する場合は、ファイルの権限または形式の問題が原因である可能性があります。