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