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 : 실행 중인 프로젝트를 취소합니다.

설치

uv를 사용하는 것은 hex-mcp를 설치하는 데 권장되는 방법입니다.

지엑스피1

또는 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 서버의 환경 변수를 설정할 때 커서가 해당 변수를 선택할 수 있도록 전역으로 설정하거나 서버를 호출할 때 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"]
    }
  }
}

일단 실행되면 Cursor에서 새로운 AI(에이전트) 대화를 시작하여 Hex 프로젝트를 나열하거나 실행하도록 요청할 수 있습니다.

[!중요] MCP 서버와 CLI는 아직 개발 중이므로 중대한 변경이 있을 수 있습니다.