hex-mcp MCP server

Name: hex-mcp MCP server
Author: franccesco

@franccesco

代码仓库

关于 hex-mcp MCP server

A MCP server to interact with Hex projects

基本信息

分类

其他

许可证

AGPL-3.0 license

运行时

python

传输方式

stdio

发布者

franccesco

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is hex-mcp?

hex-mcp is a Model Context Protocol server for Hex that provides tools to list, search, get details, run, and cancel Hex projects. It is designed for users who want to manage Hex projects programmatically, especially through AI agents in environments like Cursor.

How to use hex-mcp?

Install hex-mcp with uv add hex-mcp or pip install hex-mcp. Configure it using the hex-mcp config command (recommended) or by setting the HEX_API_KEY and HEX_API_URL environment variables. To run the server, use hex-mcp run and add a corresponding entry to your MCP client's configuration (e.g., .cursor/mcp.json for Cursor).

Key features of hex-mcp

list_hex_projects: Lists available Hex projects
search_hex_projects: Search for Hex projects by pattern
get_hex_project: Get detailed information about a specific project
get_hex_run_status: Check the status of a project run
get_hex_project_runs: Get the history of project runs
run_hex_project: Execute a Hex project
cancel_hex_run: Cancel a running project

Use cases of hex-mcp

Automate Hex project execution from AI assistants or CI/CD pipelines.
Monitor project run status and history without leaving your development environment.
Quickly locate and inspect Hex projects by name or pattern.
Integrate Hex project management into multi-step AI workflows.

FAQ from hex-mcp

How do I install hex-mcp?

Use uv add hex-mcp (recommended) or pip install hex-mcp. Verify the installation with hex-mcp --version.

How do I configure hex-mcp?

Use the hex-mcp config command, passing your API key and optionally an API URL (defaults to https://app.hex.tech/api/v1). This saves a config file to ~/.hex-mcp/config.yml. Alternatively, set the HEX_API_KEY and HEX_API_URL environment variables.

What tools does hex-mcp provide?

hex-mcp includes tools for listing, searching, and getting details on projects, as well as running, cancelling, and checking the status of project runs.

How do I use hex-mcp with Cursor?

Add a hex-mcp entry to your .cursor/mcp.json file using either "command": "uv", "args": ["run", "hex-mcp", "run"] or "command": "hex-mcp", "args": ["run"] if hex-mcp is in your PATH.