Guepard MCP SERVER

Guepard MCP サーバー - 完全な API 実装

Guepard データベース管理プラットフォーム向けの包括的な Model Context Protocol（MCP）サーバーです。整理されたモジュールを通じて、すべての Guepard API にアクセスできます。

🚀 クイックスタート

Docker Hub イメージを使用する

# Pull the image
docker pull mghassen/guepard-custom-mcp:latest

# Run the MCP server
docker run --rm -i -e ACCESS_TOKEN="your_guepard_token" mghassen/guepard-custom-mcp:latest

Cursor で使用する

Cursor の MCP 設定（~/.cursor/mcp.json）に次の内容を追加します。

{
  "mcpServers": {
    "guepard": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "ACCESS_TOKEN=your_guepard_token", "mghassen/guepard-custom-mcp:latest"],
      "env": {}
    }
  }
}

ローカル開発

# Clone the repository
git clone <repository-url>
cd guepard-mcp-server

# Install dependencies
pip install -r requirements.txt

# Set environment variables
export ACCESS_TOKEN="your_guepard_token"
export GUEPARD_API_URL="https://api.guepard.run"
export GUEPARD_AUTH_API="https://auth.guepard.run"
export SUPABASE_ANON_KEY="your_supabase_key"

# Run the server
python main.py

🛠️ 利用可能なツール

この MCP サーバーでは、整理されたモジュールを通じて、すべての Guepard API に包括的にアクセスできます。

🔐 認証

• login_supabase - Supabase 認証でログインします
• refresh_token_supabase - Supabase でアクセストークンを更新します
• logout_supabase - Supabase でログアウトし、トークンを無効化します

🚀 デプロイメント

• list_deployments - すべてのデプロイメントを取得します（任意のフィルタリングに対応）
• create_deployment - 新しいデータベースデプロイメントを作成します
• get_deployment - デプロイメントの詳細を取得します
• update_deployment - デプロイメントを更新します
• delete_deployment - デプロイメントを削除します

🌿 ブランチ

• list_branches - デプロイメントのブランチを取得します
• create_branch_from_snapshot - スナップショットから新しいブランチを作成します
• update_branch - ブランチを更新します

🔄 チェックアウト

• checkout_branch - 特定のスナップショットにチェックアウトします
• checkout_snapshot - デプロイメントからランダムなスナップショットにチェックアウトします

📸 スナップショット

• create_snapshot - スナップショットを作成します
• list_snapshots_deployment - デプロイメントのスナップショットを取得します
• list_snapshots_branch - ブランチのスナップショットを取得します

🏗️ シャドウ

• list_shadows_for_deployment - 特定のデプロイメントのシャドウデプロイメントを一覧表示します
• list_all_shadows - すべてのシャドウデプロイメントを一覧表示します
• create_shadow - スナップショットから新しいシャドウデプロイメントを作成します

🖥️ ノード

• list_nodes - すべてのノードを取得します
• create_node - 新しいノードを作成します
• get_node - ノードの詳細を取得します

⚡ パフォーマンスプロファイル

• list_performance_profiles - すべてのパフォーマンスプロファイルを取得します
• create_performance_profile - パフォーマンスプロファイルを作成します
• update_performance_profile - パフォーマンスプロファイルを更新します
• apply_performance_profile - パフォーマンスプロファイルをデプロイメントに適用します

💻 コンピューティング

• get_compute_status - コンピューティングのステータスを取得します
• get_compute - コンピューティング情報を取得します
• start_compute - デプロイメントのコンピューティングを開始します
• stop_compute - デプロイメントのコンピューティングを停止します

📊 ログとメトリクス

• get_deployment_logs - デプロイメントのログを取得します
• get_deployment_metrics - デプロイメントのメトリクスを取得します

👥 データベースユーザー

• list_database_users - デプロイメントのデータベースユーザーを取得します
• create_database_user - データベースユーザーを作成します
• update_database_user - データベースユーザーを更新します
• delete_database_user - データベースユーザーを削除します
• grant_privileges - データベースユーザーに権限を付与します
• revoke_privileges - データベースユーザーの権限を取り消します
• list_user_privileges - データベースユーザーの権限を一覧表示します

🔑 トークン

• list_tokens - すべてのトークンを取得します
• generate_token - 新しいトークンを生成します
• revoke_token - トークンを取り消します

📡 通知とサブスクリプション

• subscribe_deployment - デプロイメントの通知を購読します
• unsubscribe_deployment - デプロイメントの通知の購読を解除します
• list_subscriptions - すべてのデプロイメントサブスクリプションを一覧表示します
• manage_subscriptions - 複数のデプロイメントサブスクリプションを管理します

🛠️ ユーティリティ

• test_connection - Guepard API への接続をテストします
• list_configurations - 利用可能な定義済み設定を一覧表示します
• get_configuration - 現在のサーバー設定を取得します

📋 前提条件

• Docker がインストールされ、実行されていること（Docker を使用する場合）
• Python 3.12 以降（ローカル開発の場合）
• 有効な Guepard アクセストークン
• Cursor IDE（MCP 統合用）

🔧 設定

環境変数

必須：

• ACCESS_TOKEN：Guepard プラットフォームのアクセストークン

任意：

• GUEPARD_API_URL：Guepard API のベース URL（デフォルトは https://api.guepard.run）
• GUEPARD_AUTH_API：Guepard 認証 API の URL（デフォルトは https://auth.guepard.run）
• SUPABASE_ANON_KEY：認証用の Supabase 匿名キー
• POSTGRES16_PROFILE_ID：PostgreSQL 16 用のパフォーマンスプロファイル ID
• POSTGRES17_PROFILE_ID：PostgreSQL 17 用のパフォーマンスプロファイル ID

ツールの有効化（新機能！）：

• GUEPARD_CONFIG：事前定義された設定（minimal、read_only、production、development、monitoring）を使用します
• GUEPARD_ENABLED_MODULES：有効にするモジュールをカンマ区切りで指定します
• GUEPARD_ENABLED_TOOLS：有効にする特定のツールをカンマ区切りで指定します
• GUEPARD_DISABLED_TOOLS：無効にするツールをカンマ区切りで指定します
• GUEPARD_DISABLED_MODULES：無効にするモジュールをカンマ区切りで指定します

使用例

# Test the connection (all tools enabled)
docker run --rm -i -e ACCESS_TOKEN="your_token" mghassen/guepard-custom-mcp:latest

# Use predefined configuration (minimal tools)
docker run --rm -i -e ACCESS_TOKEN="your_token" -e GUEPARD_CONFIG="minimal" mghassen/guepard-custom-mcp:latest

# Use predefined configuration (read-only)
docker run --rm -i -e ACCESS_TOKEN="your_token" -e GUEPARD_CONFIG="read_only" mghassen/guepard-custom-mcp:latest

# Use predefined configuration (production-safe)
docker run --rm -i -e ACCESS_TOKEN="your_token" -e GUEPARD_CONFIG="production" mghassen/guepard-custom-mcp:latest

# Custom configuration (specific tools only)
docker run --rm -i -e ACCESS_TOKEN="your_token" -e GUEPARD_ENABLED_TOOLS="test_connection,list_deployments,get_deployment,start_compute,stop_compute" mghassen/guepard-custom-mcp:latest

# In Cursor, ask:
# "Test my Guepard connection"
# "Get all my deployments"
# "Create a new deployment with PostgreSQL 17"
# "Start compute for deployment xyz"
# "Create a database user with specific privileges"
# "List available configurations"
# "Get current configuration"

⚙️ ツールの有効化と設定

Guepard MCP Server は、ツールとモジュールを選択して有効化できるようになりました。用途に応じたカスタム設定を構築できます。

🚀 事前定義された設定

設定	説明	用途
minimal	最小限のデプロイ管理のみ	基本操作
read_only	デプロイとモニタリングへの読み取り専用アクセス	モニタリングダッシュボード
production	危険な操作を含まない本番環境	本番環境へのデプロイ
development	すべてのツールを含む完全な開発環境	開発作業
monitoring	モニタリングと可観測性のみ	システムモニタリング

🛠️ カスタム設定の例

# Enable only specific modules
docker run --rm -i \
  -e ACCESS_TOKEN="your_token" \
  -e GUEPARD_ENABLED_MODULES="deployments,compute" \
  mghassen/guepard-custom-mcp:latest

# Enable only specific tools
docker run --rm -i \
  -e ACCESS_TOKEN="your_token" \
  -e GUEPARD_ENABLED_TOOLS="test_connection,list_deployments,get_deployment,start_compute,stop_compute" \
  mghassen/guepard-custom-mcp:latest

# Disable dangerous operations
docker run --rm -i \
  -e ACCESS_TOKEN="your_token" \
  -e GUEPARD_DISABLED_TOOLS="delete_deployment,delete_database_user,revoke_token" \
  mghassen/guepard-custom-mcp:latest

🔍 設定の確認

組み込みツールを使用して、設定を確認できます。

• list_configurations - 利用可能な事前定義設定をすべて一覧表示します
• get_configuration - 現在のサーバー設定の詳細を取得します

🏗️ プロジェクト構成

guepard-mcp-server/
├── src/
│   └── guepard_mcp/
│       ├── auth/           # Authentication tools
│       ├── deployments/   # Deployment management
│       ├── branches/       # Branch management
│       ├── snapshots/      # Snapshot management
│       ├── shadows/        # Shadow deployment management
│       ├── nodes/          # Node management
│       ├── performance/    # Performance profiles
│       ├── compute/        # Compute management
│       ├── users/          # Database users
│       ├── tokens/         # Token management
│       ├── utils/          # Base classes and utilities
│       └── server.py       # Main server implementation
├── main.py                 # Entry point
├── requirements.txt        # Python dependencies
├── Dockerfile             # Docker configuration
└── README.md              # This file

🐳 Docker イメージ

• mghassen/guepard-custom-mcp:latest - 最新バージョン
• mghassen/guepard-custom-mcp:2.0.0 - 安定版 2.0.0

🔍 トラブルシューティング

よくある問題

1. 「ACCESS_TOKEN is required」

   • ACCESS_TOKEN 環境変数が設定されていることを確認してください
   • トークンが有効であることを確認してください

2. 「Cursor で利用可能なツールがありません」

   • mcp.json の更新後に Cursor を再起動してください
   • Docker が実行中であることを確認してください
   • イメージが取得されていることを確認してください：docker pull mghassen/guepard-custom-mcp:latest

3. 接続の問題

   • まず接続をテストしてください：docker run --rm -i -e ACCESS_TOKEN="your_token" mghassen/guepard-custom-mcp:latest
   • インターネット接続を確認してください
   • Guepard の認証情報が有効であることを確認してください

4. 認証エラー

   • 認証操作で SUPABASE_ANON_KEY が設定されていることを確認してください
   • GUEPARD_AUTH_API が正しいことを確認してください

デバッグモード

デバッグログを有効にして実行します：

docker run --rm -i -e ACCESS_TOKEN="your_token" -e DEBUG=true mghassen/guepard-custom-mcp:latest

📚 API リファレンス

ツールのパラメーター

認証ツール

• login_supabase：email（必須）、password（必須）
• refresh_token_supabase：refresh_token（必須）
• logout_supabase：refresh_token（必須）

デプロイツール

• list_deployments：status（任意）、limit（任意）
• create_deployment：repository_name（必須）、performance_profile_id（必須）、および任意のフィールド
• get_deployment：deployment_id（必須）
• update_deployment：deployment_id（必須）、および更新するフィールド
• delete_deployment：deployment_id（必須）

ブランチツール

• list_branches：deployment_id（必須）
• create_branch_from_snapshot：deployment_id、branch_id、snapshot_id、branch_name（すべて必須）、is_ephemeral（任意）
• update_branch：deployment_id、branch_id（必須）、および更新するフィールド

チェックアウトツール

• checkout_branch：deployment_id、branch_id、snapshot_id（すべて必須）
• checkout_snapshot：deployment_id（必須）、および任意のパラメーター

スナップショットツール

• create_snapshot：deployment_id、branch_id、snapshot_comment（すべて必須）
• list_snapshots_deployment：deployment_id（必須）
• list_snapshots_branch：deployment_id、branch_id（両方必須）

シャドウツール

• list_shadows_for_deployment：deployment_id（必須）
• list_all_shadows：パラメーターなし
• create_shadow：deployment_id、snapshot_id、repository_name、branch_name、performance_profile_id（すべて必須）

ノードツール

• list_nodes：パラメーターなし
• create_node：label_name、node_type、memory、cpu、storage（必須）、および任意のフィールド
• get_node：node_id（必須）

パフォーマンスプロファイルツール

• list_performance_profiles：パラメーターなし
• create_performance_profile：label_name、min_cpu、min_memory（必須）、および任意のフィールド
• update_performance_profile：performance_profile_id（必須）、および更新するフィールド
• apply_performance_profile：deployment_id、performance_profile_id（両方必須）

コンピューティングツール

• get_compute_status：deployment_id（必須）
• get_compute：deployment_id（必須）
• start_compute：deployment_id（必須）、notify（任意）
• stop_compute：deployment_id（必須）、notify（任意）

ログとメトリクスのツール

• get_deployment_logs：deployment_id（必須）、lines（任意）、level（任意）、component（任意）
• get_deployment_metrics：deployment_id（必須）、time_range（任意）、metric_type（任意）

データベースユーザーツール

• list_database_users：deployment_id（必須）
• create_database_user：deployment_id、username、password（必須）、privileges（任意）
• update_database_user：deployment_id、username（必須）、password（任意）
• delete_database_user：deployment_id、username（必須）
• grant_privileges：deployment_id、username、privileges（すべて必須）
• revoke_privileges：deployment_id、username、privileges（すべて必須）
• list_user_privileges：deployment_id、username（両方必須）

トークンツール

• list_tokens：パラメーターなし
• generate_token：name（必須）、expires_in（任意）
• revoke_token：token_id（必須）

通知とサブスクリプションのツール

• subscribe_deployment：deployment_id（必須）
• unsubscribe_deployment：deployment_id（必須）
• list_subscriptions：パラメーターなし
• manage_subscriptions：action（必須）、deployment_ids（必須）

ユーティリティツール

• test_connection：パラメーターなし
• list_configurations：パラメーターなし
• get_configuration：パラメーターなし

🆘 サポート

• 問題報告：GitHub で問題を報告してください
• ドキュメント：メインの README.md を確認してください
• Guepard Platform：guepard.run にアクセスしてください

📄 ライセンス

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

---

すぐに使えます！ イメージをプルして、Cursor で Guepard のデプロイメントを管理しましょう！ 🎉