Hex API MCP Server

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 を使用することをお勧めします。

または pip を使用します:

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

構成

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

hex-mcp を構成する最も簡単な方法は、 configコマンドを使用して、API キーと 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ファイルを作成してください。

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

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

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