1panel MCP

🚀 1Panel MCP サーバー

モデルコンテキストプロトコル（MCP）サーバーを使用して、ウェブサイトを1Panelに自動的にデプロイするためのサーバーです。

⚠️ 重要な注意事項

現在、このプロジェクトは実験段階にあり、実際の運用には適していません。

🚀 クイックスタート

ビデオデモ

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

✨ 主な機能

• ウェブサイトを1Panelサーバーに自動的にデプロイする
• 存在しないウェブサイトを作成する
• 静的ウェブサイトファイルを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>"
      }
    }
  }
}

MCPを使用してウェブサイトをデプロイする

Cursorでは、AIチャットウィンドウで以下のコマンドを使用してウェブサイトをデプロイできます。

将网站部署到1Panel，域名为 yourdomain.com

または以下の形式を使用します。

将网站部署到1Panel服务器，域名：yourdomain.com

📚 ドキュメント

API リファレンス

MCP ツール：deploy_website

ウェブサイトを1Panelにデプロイします。

パラメータ：

• domain（必須）：ウェブサイトのドメイン名
• buildDir（任意）：ビルドディレクトリのパス

レスポンス：

成功部署到1Panel！
域名：yourdomain.com
URL：http://yourdomain.com
上传统计信息：
- 总文件数：25
- 成功上传：25
- 失败上传：0

🔧 技術詳細

デプロイプロセス

1. ビルドディレクトリの確認：指定されたビルドディレクトリが存在することを検証する
2. ウェブサイトの作成：1Panel APIを使用して、新しい静的ウェブサイトを作成する（存在しない場合）
3. ファイルのアップロード：ビルドディレクトリからすべてのファイルをウェブサイトにアップロードする
4. 統計情報：アップロードプロセスに関する詳細な統計データを返す

トラブルシューティング

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

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