Unraid MCP

🚀 Unraid MCP サーバーガイド

Unraid MCP サーバーは、Unraid システムの各種情報や機能にアクセスするためのサーバーです。このガイドを通じて、サーバーのインストール、設定、使用方法を学ぶことができます。

🚀 クイックスタート

📦 インストール

環境要求

• オペレーティングシステム：Linux または Windows
• Python バージョン：3.6 以上

ダウンロードとインストール

1. リポジトリをクローンします：

git clone https://github.com/your-repository/unraid-mcp.git
cd unraid-mcp

2. 依存関係をインストールします：

pip install -r requirements.txt

設定

unraid_mcp_config.json という名前の設定ファイルを作成します：

{
  "mcpServers": {
    "unraid": {
      "command": "/path/to/python",
      "args": ["/path/to/unraid-mcp/run_server.py"],
      "env": {
        "UNRAID_API_URL": "http://your-unraid-server:port/graphql",
        "UNRAID_API_KEY": "your-api-key",
        "LOG_LEVEL": "INFO",
        "CLAUDE_MCP_SERVER": "true"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

✨ 主な機能

リソースアクセス

• unraid://system/info：システム情報（CPU、メモリ、稼働時間）
• unraid://system/plugins：インストールされているプラグイン
• unraid://docker/containers：すべての Docker コンテナのリスト
• unraid://docker/{container_name}：特定のコンテナの詳細
• unraid://array/status：現在のストレージアレイの状態
• unraid://vms/list：すべての仮想マシンのリスト
• unraid://vms/{vm_name}：特定の仮想マシンの詳細
• unraid://storage/shares：ユーザー共有情報

ツールセット

システム管理

• get_system_info：詳細なシステム情報を取得
• get_network_info：ネットワークインターフェイス情報を取得

ストレージアレイ管理

• get_array_status：現在のアレイ状態を人間が読みやすい形式で表示
• get_parity_history：パリティチェックの履歴を取得

Docker 管理

• get_docker_containers：Docker コンテナ情報を取得
• get_docker_networks：Docker ネットワーク情報を取得
• list_containers：Docker コンテナを人間が読みやすい形式でリスト表示

仮想マシン管理

• get_vms：仮想マシン情報を取得
• get_vm_details：特定の仮想マシンの詳細情報を取得
• list_vms：仮想マシンを人間が読みやすい形式でリスト表示

通知管理

• get_notifications：サーバー上の通知を取得
• create_notification：新しい通知を作成
• archive_notification：指定された通知をアーカイブ

共有管理

• get_shares：ネットワーク共有情報を取得
• get_share_details：特定の共有の詳細情報を取得

ディスク管理

• get_disks：すべてのディスク情報を取得
• get_disk_details：特定のディスクの詳細情報を取得
• get_unassigned_devices：割り当てられていないデバイス情報を取得

ユーザー管理

• get_users：すべてのユーザー情報を取得

API キー管理

• get_api_keys：すべての API キー情報を取得

💻 使用例

基本的な使用法

と Claude の統合

1. 設定ファイルを作成します：

{
  "mcpServers": {
    "unraid": {
      "command": "/path/to/python",
      "args": ["/path/to/unraid-mcp/run_server.py"],
      "env": {
        "UNRAID_API_URL": "http://your-unraid-server:port/graphql",
        "UNRAID_API_KEY": "your-api-key",
        "LOG_LEVEL": "INFO",
        "CLAUDE_MCP_SERVER": "true"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

サンプルクエリ

curl -X GET http://localhost:port/unraid//system/info

🔧 エラー処理

一般的な問題

• 接続失敗：API アドレスとキーが正しいことを確認してください。
• 権限問題：アクセス権限が十分であることを確認してください。

ログの確認

ログファイルは logs/unraid_mcp.log にあり、詳細なエラー情報が含まれています。

🔄 アップグレードとメンテナンス

コードの更新

git pull origin main
pip install -r requirements.txt

サービスの再起動

systemctl restart unraid-mcp

🛡️ セキュリティに関する注意事項

• キー管理：API キーの安全性を確保し、漏洩を防いでください。
• ネットワークアクセス：MCP サーバーへの外部からのアクセスを制限してください。

以上の手順に従って、Unraid の MCP サーバーを設定し、開発環境に統合することができます。さらなる支援が必要な場合は、公式ドキュメントを参照するか、サポートチームにお問い合わせください。