Whm MCP Server

🚀 WHM 管理コントロールパネル（MCP）

このアプリケーションは Node.js ベースのサーバーアプリで、WHM（Web Host Manager）サーバーに接続してアカウント管理やサービス管理を行います。また、AI アシスタント（Claude など）と WHM API のやり取りを可能にするため、モデルコンテキストプロトコル（MCP）を実装しています。

✨ 主な機能

• アカウント管理（作成、変更、一時停止、終了）
• サーバー情報と統計
• サーバーの更新とメンテナンス
• SSL 証明書管理
• バックアップ管理
• メールアカウント管理
• ドメイン管理
• セキュリティ機能
• AI アシスタントとの統合をサポートする MCP プロトコルの実装

📦 インストール

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. .env ファイルを設定し、WHM サーバーの詳細情報を入力します。

   # WHM サーバー設定
   WHM_SERVER=your-server-domain.com
   WHM_PORT=2087
   WHM_USERNAME=root
   WHM_API_TOKEN=your-api-token-here
   
   # MCP サーバー設定
   PORT=3000
   NODE_ENV=development
   LOG_LEVEL=info
   
   # API 認証
   API_KEY=your-secret-api-key-here
   

4. サーバーを起動します。

   npm start
   

開発環境での使用は以下のコマンドを実行します。

npm run dev

📚 MCP サーバー設定

この MCP サーバーを AI アシスタント（Cursor 内の Claude など）と一緒に使用するには、mcp.json ファイルに以下の設定を追加する必要があります。

{
  "mcpServers": {
    "whm": {
      "url": "http://your-server-address:3000/sse"
    }
  }
}

🔧 技術詳細

このサーバーは、HTTP サーバー送信イベント（SSE）を伝送メカニズムとして使用して、モデルコンテキストプロトコルを実装しています。実装は標準の JSON - RPC 2.0 形式のすべてのメッセージに準拠しており、以下を含みます。

• 永続的な接続を確立するための /sse エンドポイント
• クライアントのリクエストを受信して応答するための /messages エンドポイント
• 能動的な connection/ready と tools/ready 通知
• 適切なエラーコードを持つ標準化されたエラー処理

MCP アーキテクチャにより、AI アシスタントは明確に定義されたツールを介して WHM 機能と安全にやり取りできます。パラメータモードは、言語モデルとサーバー管理機能の間に安全な橋渡しを提供します。

💻 使用例

利用可能な MCP ツール

この MCP サーバーは、以下のツールを介して WHM 機能を公開しています。

基本的な使用法

• アカウント管理
  • すべてのアカウントを表示：すべてのユーザーアカウントをリストします。
  • 新しいアカウントを作成：新しいユーザーアカウントを追加します。
  • 指定されたアカウントを削除：特定のユーザーアカウントを削除します。
• サーバー情報と統計
  • サーバーの状態を取得：現在のサーバーの実行状態を返します。
  • リソース使用状況を表示：CPU、メモリなどのリソース使用状況の詳細を表示します。

📄 API ドキュメント

完全な API ドキュメントについては、公式ドキュメントリンク を参照してください。

⚠️ 重要提示

• 必ず WHM_API_TOKEN を保護し、第三者に漏洩しないようにしてください。これにより、不正なアクセスを防ぐことができます。
• 本番環境では、SSL 証明書を有効にして通信を暗号化することをおすすめします。
• サーバーと関連コンポーネントを定期的に更新し、既知の脆弱性から保護してください。

💻 テスト

同梱のサンプルクライアントを使用して MCP サーバーをテストできます。

npm run example

これにより、MCP サーバーに接続し、利用可能なツールを要求し、サンプルコマンドを実行する簡単なテストクライアントが実行されます。