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] 这会将你的配置保存到你 home 目录下的一个文件中 (例如 ~/.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 仍在开发中，可能会有重大更改。