hex-mcp 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 : 実行中のプロジェクトをキャンセルする

インストール

hex-mcp をインストールするには、uv を使用することをお勧めします。

uv add hex-mcp

または pip を使用します:

pip install hex-mcp

動作していることを確認するには、次のコマンドを実行します。

hex-mcp --version

Related MCP server: Integrator MCP Server

構成

configコマンドの使用（推奨）

hex-mcp を構成する最も簡単な方法は、 configコマンドを使用して、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"

[!NOTE] これにより、設定がホーム ディレクトリ内のファイル (例: ~/.hex-mcp/config.yml ) に保存され、すべての hex-mcp 呼び出しで使用できるようになります。

環境変数の使用

あるいは、環境変数を使用して Hex MCP サーバーを構成することもできます。

• HEX_API_KEY : Hex APIキー

• HEX_API_URL : Hex API ベース URL

MCP サーバーの環境変数を設定するときは、Cursor がそれを取得できるようにグローバルにするか、サーバーの呼び出し時に uv の--env-fileフラグを使用する必要があります。

カーソルの使用

Cursor は、AI エージェントが MCP プロトコルを介して Hex と対話できるようにします。Cursor で hex-mcp を設定して使用するには、以下の手順に従ってください。プロジェクトのルートに、以下の内容を含む.cursor/mcp.jsonファイルを作成してください。

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

あるいは、PATH 内にある場合は、 hex-mcpコマンドを直接使用することもできます。

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

起動したら、新しい AI (エージェント) 会話を開始して、Hex プロジェクトをリストまたは実行するように依頼することで、Cursor で使用できます。

[!IMPORTANT] MCP サーバーおよび CLI はまだ開発中であり、重大な変更が行われる可能性があります。