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 的推荐方法:
或者使用 pip:
为了确认它正常工作,您可以运行:
Related MCP server: Unity MCP Integration
配置
使用 config 命令(推荐)
配置 hex-mcp 最简单的方法是使用config命令并传递你的 API 密钥和 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
在为 MCP 服务器设置环境变量时,它们必须是全局的,以便 Cursor 能够获取它们,或者在调用服务器时使用 uv 的--env-file标志。
与游标一起使用
Cursor 允许 AI 代理通过 MCP 协议与 Hex 交互。请按照以下步骤设置并使用 hex-mcp 与 Cursor 交互。您可以在项目根目录中创建一个.cursor/mcp.json文件,其中包含以下内容:
或者,如果hex-mcp命令在您的 PATH 中,您可以直接使用它:
一旦它启动并运行,您就可以在 Cursor 中使用它,通过启动新的 AI(代理)对话并要求它列出或运行 Hex 项目。
MCP 服务器和 CLI 仍处于开发阶段,可能会发生重大变化。