Hex MCP

🚀 Hex-MCP サーバー

Hex 用に実装された MCP サーバーで、以下のツールをサポートしています。

• list_hex_projects：利用可能な Hex プロジェクトをリスト表示します。
• search_hex_projects：パターンに基づいて Hex プロジェクトを検索します。
• get_hex_project：特定のプロジェクトの詳細情報を取得します。
• get_hex_run_status：プロジェクトの実行状態を確認します。
• get_hex_project_runs：プロジェクトの実行履歴を取得します。
• run_hex_project：Hex プロジェクトを実行します。
• cancel_hex_run：実行中のプロジェクトをキャンセルします。

📦 インストール

uv を使用することが推奨されるインストール方法です。

uv add hex-mcp

または、pip を使用することもできます。

pip install hex-mcp

正常に動作していることを確認するコマンドは以下の通りです。

hex-mcp --version

🔧 設定

config コマンドを使用する（推奨）

config コマンドを使用して hex-mcp を設定し、API キーと API URL（オプション、デフォルトは https://app.hex.tech/api/v1）を渡します。

hex-mcp config --api-key "your_hex_api_key" --api-url "https://app.hex.tech/api/v1"

⚠️ 重要提示

これにより、設定がユーザーディレクトリ内のファイル（例：~/.hex-mcp/config.yml）に保存され、すべての hex-mcp 呼び出しで利用可能になります。

環境変数を使用する

また、Hex MCP サーバーは環境変数を使用して設定することもできます。

• HEX_API_KEY：あなたの Hex API キー
• HEX_API_URL：Hex API のベース URL

Cursor で MCP サーバーの環境変数を設定する場合、それらはグローバルに有効である必要があります。または、uv の --env-file フラグを使用してサーバーを呼び出す際に渡すことができます。

💻 使用例

Cursor では、AI エージェントが MCP プロトコルを介して Hex とやり取りできます。以下の手順に従って、hex-mcp を Cursor と一緒に設定して使用します。

プロジェクトのルートディレクトリに .cursor/mcp.json ファイルを作成し、以下の内容を記述します。

{
  "mcpServers": {
    "hex-mcp": {
      "command": "uv",
      "args": ["run", "hex-mcp", "run"]
    }
  }
}

または、PATH に hex-mcp コマンドが含まれている場合は、直接以下のように使用できます。

{
  "mcpServers": {
    "hex-mcp": {
      "command": "hex-mcp",
      "args": ["run"]
    }
  }
}

起動したら、Cursor で新しい AI（エージェント）対話を開始し、Hex プロジェクトのリスト表示や実行を要求することで使用できます。

⚠️ 重要提示

MCP サーバーと CLI はまだ開発中であり、破壊的な変更が加えられる可能性があります。