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를 사용하면:
제대로 작동하는지 확인하려면 다음을 실행하세요.
구성
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 서버의 환경 변수를 설정할 때 커서가 해당 변수를 선택할 수 있도록 전역으로 설정하거나 서버를 호출할 때 uv의 --env-file
플래그를 활용해야 합니다.
커서와 함께 사용
Cursor를 사용하면 AI 에이전트가 MCP 프로토콜을 통해 Hex와 상호 작용할 수 있습니다. 다음 단계에 따라 Cursor와 함께 hex-mcp를 설정하고 사용할 수 있습니다. 프로젝트 루트에 다음 내용으로 .cursor/mcp.json
파일을 생성할 수 있습니다.
또는 PATH에 hex-mcp
명령이 있다면 직접 사용할 수 있습니다.
일단 실행되면 Cursor에서 새로운 AI(에이전트) 대화를 시작하여 Hex 프로젝트를 나열하거나 실행하도록 요청할 수 있습니다.
[!중요] MCP 서버와 CLI는 아직 개발 중이므로 중대한 변경이 있을 수 있습니다.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
AI 어시스턴트가 표준화된 인터페이스를 통해 Hex 프로젝트에 액세스하고, 이를 보고, 실행하고, 관리할 수 있도록 해주는 서버입니다.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA server that enhances AI assistants with the ability to update your JSON Resume by analyzing your coding projects, automatically extracting skills and generating professional descriptions.Last updated -33239TypeScriptThe Unlicense
- -securityAlicense-qualityA server that enables AI assistants to understand and interact with Unity projects in real-time, providing access to scene hierarchy, project settings, and the ability to execute code directly in the Unity Editor.Last updated -40MIT License
- -securityFlicense-qualityA server that enables AI assistants to interact with Linear's project management tools through the Model Context Protocol, supporting features like searching, creating, and updating issues, adding comments, and retrieving user profiles and team information.Last updated -TypeScript
- -securityAlicense-qualityA server that enables AI assistants like Claude to safely run Python code and access websites, processing data for better AI understanding while providing helpful error messages.Last updated -2PythonGPL 3.0