hatchbox

Hatchbox MCP サーバー

小規模事業者向けに Rails のホスティングをシンプルにする Hatchbox 用の MCP サーバーです。

概要

この MCP サーバーは、Hatchbox の API と連携するツールを提供します。これにより、AI アシスタントから Rails アプリケーションの環境変数やデプロイを直接管理できます。

主な機能

• 環境変数の管理：
  • すべての環境変数を表示（SSH 経由）
  • 特定の環境変数を取得（SSH 経由）
  • 環境変数を設定および更新
  • 環境変数を削除
• デプロイの制御：デプロイを開始し、ステータスを確認
• セキュリティ機能：
  • デフォルトで読み取り専用モード
  • デプロイ権限を設定可能
  • 環境変数の読み取りには SSH ベースの安全なアクセスを使用
• 安全な認証：安全なアクセスのために API キーと SSH キーを使用

インストール

npm install hatchbox-mcp-server

設定

環境変数

必須の変数

• HATCHBOX_API_KEY：認証用の Hatchbox API キー
• HATCHBOX_ACCOUNT_ID：Hatchbox アカウント ID
• HATCHBOX_APP_ID：Hatchbox アプリケーション ID
• HATCHBOX_DEPLOY_KEY：デプロイ用の Webhook キー

SSH アクセス用の任意の変数

• WEB_SERVER_IP_ADDRESS：Hatchbox サーバーの IP アドレス（getEnvVars および getEnvVar ツールを有効にします）
• SSH_KEY_PATH：SSH 秘密鍵へのパス（デフォルトは ~/.ssh/id_rsa）
• HATCHBOX_APP_NAME：サーバー上に複数のアプリがある場合にプロセスを絞り込むためのアプリ名（以下の例を参照）

セキュリティ設定

• READONLY：書き込み操作を有効にするには false に設定します（デフォルト：true）
• ALLOW_DEPLOYS：デプロイ操作を無効にするには false に設定します（デフォルト：true）

これらの値は Hatchbox ダッシュボードで確認できます。

• API キー：アカウント設定
• アカウント ID：アカウントの表示中に URL に表示されます
• アプリ ID：アプリケーションの表示中に URL に表示されます
• デプロイキー：アプリケーションのデプロイ設定
• サーバー IP：サーバーのパブリック IP アドレス（SSH アクセス用）

SSH の設定（任意：環境変数の読み取り用）

getEnvVars および getEnvVar ツールを有効にするには、Hatchbox サーバーへの SSH アクセスが必要です。

1. SSH 公開鍵を追加：Hatchbox サーバー上のデプロイユーザーに追加します。

   ssh-copy-id deploy@your-server-ip
   

2. SSH アクセスをテストします。

   ssh deploy@your-server-ip "echo 'SSH access working'"
   

3. サーバーの IP アドレスを使って MCP サーバーを設定します（以下の設定を参照）。

同じサーバー上の複数のアプリ

同じ Hatchbox サーバー上で複数の Rails アプリケーションを実行している場合は、どのアプリの環境変数を読み取るか特定するために HATCHBOX_APP_NAME を指定する必要があります。

# Example: If your server has multiple apps running
# App 1: mystore (running on port 3000)
# App 2: blog (running on port 3001)
# App 3: api (running on port 3002)

# To read env vars for the 'mystore' app:
HATCHBOX_APP_NAME=mystore

# To read env vars for the 'blog' app:
HATCHBOX_APP_NAME=blog

アプリ名は Hatchbox ダッシュボードに表示されている名前と一致させてください。これにより、プロセス一覧が絞り込まれ、対象のアプリケーションに対応する puma プロセスを見つけられます。

Claude Desktop の設定

Claude Desktop の設定ファイルにサーバーを追加します。

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hatchbox": {
      "command": "npx",
      "args": ["-y", "hatchbox-mcp-server"],
      "env": {
        "HATCHBOX_API_KEY": "your-api-key-here",
        "HATCHBOX_ACCOUNT_ID": "1852",
        "HATCHBOX_APP_ID": "8540",
        "HATCHBOX_DEPLOY_KEY": "your-deploy-key-here",

        "// Optional - for SSH access to read env vars": "",
        "WEB_SERVER_IP_ADDRESS": "165.232.133.75",
        "SSH_KEY_PATH": "/Users/yourname/.ssh/id_rsa",
        "HATCHBOX_APP_NAME": "myapp",

        "// Optional - security settings": "",
        "READONLY": "false",
        "ALLOW_DEPLOYS": "true"
      }
    }
  }
}

ツール

環境変数

getEnvVars

SSH 経由で Hatchbox サーバーからすべての環境変数を取得します。

要件： WEB_SERVER_IP_ADDRESS の設定が必要です。

パラメーター： なし

例：

"Show me all environment variables"

getEnvVar

SSH 経由で Hatchbox サーバーから特定の環境変数を取得します。

要件： WEB_SERVER_IP_ADDRESS の設定が必要です。

パラメーター：

• name（文字列、必須）：取得する環境変数の名前

例：

{
  "name": "RAILS_ENV"
}

setEnvVar

環境変数を設定または更新します。

要件： READONLY を false に設定する必要があります。

パラメーター：

• name（文字列、必須）：環境変数名
• value（文字列、必須）：環境変数の値

例：

{
  "name": "DATABASE_URL",
  "value": "postgres://user:pass@host:5432/dbname"
}

deleteEnvVars

1 つ以上の環境変数を削除します。

要件： READONLY を false に設定する必要があります。

パラメーター：

• names（文字列の配列、必須）：削除する環境変数名の配列

例：

{
  "names": ["OLD_VAR", "UNUSED_VAR"]
}

デプロイ

triggerDeploy

アプリケーションの新しいデプロイを開始します。

要件： ALLOW_DEPLOYS を true（デフォルト）に設定する必要があります。

パラメーター：

• sha（文字列、任意）：デプロイする特定のコミット SHA（指定しない場合は最新のもの）

例：

{
  "sha": "abc123def456"
}

checkDeploy

デプロイのステータスを確認します。

要件： ALLOW_DEPLOYS を true（デフォルト）に設定する必要があります。

パラメーター：

• activityId（文字列、必須）：triggerDeploy から返されるデプロイアクティビティ ID

例：

{
  "activityId": "12345"
}

使用例

Claude で使用できるクエリの例を紹介します。

環境変数の読み取り（WEB_SERVER_IP_ADDRESS が必要）

1. すべての環境変数を表示する： 「すべての環境変数を表示して」

2. 特定の変数を取得する： 「RAILS_ENV の値は何？」

環境変数の書き込み（READONLY=false が必要）

3. 環境変数を設定する： 「RAILS_ENV を production に設定して」

4. 環境変数を削除する： 「OLD_VAR と UNUSED_VAR の環境変数を削除して」

デプロイ（ALLOW_DEPLOYS=true が必要）

5. 最新のコードをデプロイする： 「最新のコミットを Hatchbox にデプロイして」

6. 特定のコミットをデプロイする： 「コミット abc123def456 を Hatchbox にデプロイして」

7. デプロイのステータスを確認する： 「デプロイアクティビティ 12345 のステータスを確認して」

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

API セキュリティ

• API キーは安全に保管し、バージョン管理に決してコミットしないでください
• サーバーがアクセスできるのは、API キーでアクセス可能な Hatchbox アカウントとアプリケーションのみです

SSH セキュリティ

• SSH アクセスでは、シークレットを含むすべての環境変数が公開されます
• SSH キーが適切に保護されていることを確認してください
• 可能であれば、読み取り専用の SSH キーを専用に用意することを検討してください
• シークレットを MCP クライアントに信頼して預けられる場合にのみ、WEB_SERVER_IP_ADDRESS を設定してください

権限モード

• 読み取り専用モード（デフォルト）： 本番環境への意図しない変更を防ぎます
• デプロイ制御： 書き込み操作とは別に無効化できます
• セキュリティ要件に応じて権限を設定してください：
  • 開発：READONLY=false、ALLOW_DEPLOYS=true
  • ステージング：READONLY=false、ALLOW_DEPLOYS=true
  • 本番：READONLY=true、ALLOW_DEPLOYS=false（推奨）
• すべての API 通信は HTTPS を使用して暗号化されます

開発

このサーバーは、PulseMCP 組織が提供する MCP サーバーコレクションの一部です。開発手順と貢献ガイドラインについては、メインリポジトリを参照してください。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。