Rook Ceph Mcp

Rook Ceph MCP サーバー

Kubernetes 環境で Rook Ceph ストレージクラスターを管理するための Model Context Protocol（MCP）サーバーです。

機能

• クラスター管理：Ceph クラスターの一覧表示と監視
• ストレージリソース：ブロックプール、ファイルシステム、オブジェクトストアを管理
• マニフェストテンプレート：一般的なリソース向けの事前設定済み YAML テンプレートにアクセス
• Kubernetes との統合：Kubernetes API とネイティブに統合
• トラブルシューティング：クラスターのセットアップとトラブルシューティング用の組み込みプロンプト

インストール

ローカル開発（stdio トランスポート）

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

npm install

2. プロジェクトをビルドします：

npm run build

3. サーバーを起動します：

npm run start:stdio

クラウドホスティング（HTTP トランスポート）

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

npm install

2. プロジェクトをビルドします：

npm run build

3. HTTP サーバーを起動します：

npm start

Docker デプロイ

1. Docker イメージをビルドします：

docker build -t rook-ceph-mcp .

2. コンテナを実行します：

docker run -p 3000:3000 rook-ceph-mcp

設定

このサーバーを使用するには、Rook Ceph がインストールされた Kubernetes クラスターへのアクセスが必要です。認証にはデフォルトの kubeconfig を使用します。

前提条件

• Rook Ceph オペレーターがインストールされた Kubernetes クラスター
• クラスターにアクセスできるよう設定された kubectl
• Node.js 18 以降および npm

利用可能なツール

クラスター操作

• list_clusters - すべての Ceph クラスターを一覧表示
• get_cluster_status - 指定したクラスターの詳細なステータスを取得

ストレージリソース

• list_block_pools - すべての Ceph ブロックプールを一覧表示
• list_filesystems - すべての Ceph ファイルシステムを一覧表示
• list_object_stores - すべての Ceph オブジェクトストアを一覧表示

リソース管理

• create_block_pool - 新しい Ceph ブロックプールを作成
• delete_resource - Rook Ceph リソースを削除

利用可能なリソース

サーバーは次の YAML マニフェストテンプレートを提供します：

• rook-ceph://manifests/cluster - Ceph クラスターの設定
• rook-ceph://manifests/block-pool - ブロックプールの設定
• rook-ceph://manifests/filesystem - ファイルシステムの設定
• rook-ceph://manifests/object-store - オブジェクトストアの設定

利用可能なプロンプト

• setup_cluster - クラスターのセットアップ手順ガイド
• troubleshoot_cluster - クラスターのトラブルシューティング支援

使用例

すべてのクラスターを一覧表示

{
  "tool": "list_clusters",
  "arguments": {
    "namespace": "rook-ceph"
  }
}

ブロックプールを作成

{
  "tool": "create_block_pool",
  "arguments": {
    "name": "my-pool",
    "namespace": "rook-ceph",
    "replicated": {
      "size": 3
    }
  }
}

クラスターのステータスを取得

{
  "tool": "get_cluster_status",
  "arguments": {
    "name": "rook-ceph",
    "namespace": "rook-ceph"
  }
}

リポジトリ構成

元の git リポジトリの仕様に基づき、このプロジェクトではブランチごとに YAML マニフェストとして MCP コンテキストを管理しています：

• main - 本番コンテキスト
• staging - ステージングコンテキスト
• dev - 開発コンテキスト

各ブランチには次の内容が含まれます：

├── cluster-manifests/
│   ├── ceph-cluster.yaml
│   ├── object-store.yaml
│   └── block-pool.yaml
├── apps/
│   ├── rook-operator.yaml
│   ├── monitoring-stack.yaml
│   └── security.yaml
├── kustomization.yaml
└── README.md

API エンドポイント（HTTP モード）

HTTP モードで実行すると、サーバーは次のエンドポイントを公開します：

• GET /health - ヘルスチェック
• GET /mcp/tools - 利用可能なツールを一覧表示
• POST /mcp/call-tool - ツールを実行
• GET /mcp/resources - 利用可能なリソースを一覧表示
• POST /mcp/read-resource - リソースを読み取る
• GET /mcp/prompts - 利用可能なプロンプトを一覧表示
• POST /mcp/get-prompt - プロンプトを取得

開発

ビルド

npm run build

開発モード（stdio）

npm run dev:stdio

開発モード（HTTP）

npm run dev

テスト

npm test

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. 該当する場合はテストを追加します
5. プルリクエストを送信します

ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください

サポート

問題や質問については：

• サーバーに組み込まれたトラブルシューティング用プロンプトを確認してください
• Rook Ceph のドキュメントを参照してください
• プロジェクトリポジトリに問題を報告してください

セキュリティ

このサーバーには Kubernetes クラスターへのアクセスが必要です。適切な RBAC 権限を設定して使用してください。本番環境にデプロイする際は、常にセキュリティのベストプラクティスに従ってください。