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：

uv add hex-mcp

或者使用pip：

pip install hex-mcp

确认安装成功，可以运行：

hex-mcp --version

配置

使用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一起使用

Cursor允许AI代理通过MCP协议与Hex进行交互。按照以下步骤设置并使用hex-mcp与Cursor。您可以在项目根目录创建一个.cursor/mcp.json文件，内容如下：

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

或者，如果hex-mcp在您的PATH中，可以直接使用hex-mcp命令：

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

一旦启动并运行，您就可以在Cursor中通过启动新的AI（代理）对话并请求列出或运行Hex项目来使用它。

[!IMPORTANT] MCP服务器和CLI仍在开发中，可能会有重大变更。