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

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 服务器设置环境变量时，它们必须是全局的，以便 Cursor 能够获取它们，或者在调用服务器时使用 uv 的--env-file标志。

与游标一起使用

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

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

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

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

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

[!IMPORTANT] MCP 服务器和 CLI 仍处于开发阶段，可能会发生重大变化。