Hex MCP

🚀 Hex-MCP 服務器

Hex-MCP 服務器是專為 Hex 打造的 MCP 服務器，它提供了一系列實用工具，可幫助用戶方便地管理和操作 Hex 項目，如列出項目、搜索項目、獲取項目詳情等。

🚀 快速開始

Hex-MCP 服務器為用戶提供了便捷的 Hex 項目管理方式。通過一系列工具，用戶可以輕鬆地與 Hex 平臺進行交互，執行各種操作。

✨ 主要特性

• 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 是推薦的安裝方式：

uv add hex-mcp

或者使用 pip：

pip install hex-mcp

確認是否正常工作的命令：

hex-mcp --version

📚 詳細文檔

配置

使用 config 命令（推薦）

通過 config 命令配置 hex-mcp，傳遞你的 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"

⚠️ 重要提示

這會將配置保存到你用戶目錄中的文件（例如 ~/.hex-mcp/config.yml），使其在所有 hex-mcp 調用中可用。

使用環境變量

或者，Hex MCP 服務器也可以通過環境變量進行配置：

• HEX_API_KEY：你的 Hex API 密鑰。
• HEX_API_URL：Hex API 的基礎 URL。

當為 Cursor 設置 MCP 服務器的環境變量時，它們需要全局有效，或使用 uv 的 --env-file 標誌在調用服務器時傳遞。

與 Cursor 使用

Cursor 允許 AI 代理通過 MCP 協議與 Hex 交互。按照以下步驟設置並使用 hex-mcp 與 Cursor 配合： 在項目根目錄中創建一個 .cursor/mcp.json 文件，內容如下：

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

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

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

一旦運行起來，你可以在 Cursor 中通過啟動新的 AI（代理）對話並要求其列出或運行 Hex 項目來使用它。

⚠️ 重要提示

MCP 服務器和 CLI 仍在開發中，可能會有破壞性更改。