hex-mcp MCP server
2025.03.20
0
PythonHex 项目管理自动化执行开发效率
hex-mcp 是一个为 Hex 项目设计的 MCP 服务器，提供了多种工具来管理和操作 Hex 项目。其核心功能包括列出、搜索、获取项目信息、检查运行状态、获取运行历史、执行项目以及取消运行等。适用于开发者在 Hex 平台上进行项目管理和自动化操作。
View on GitHub
Overview
基本能力
产品定位
hex-mcp 是一个为 Hex 项目设计的 MCP 服务器，主要用于管理和操作 Hex 项目。
核心功能
- 列出可用的 Hex 项目 (
list_hex_projects) - 通过模式搜索 Hex 项目 (
search_hex_projects) - 获取特定项目的详细信息 (
get_hex_project) - 检查项目运行状态 (
get_hex_run_status) - 获取项目运行历史 (
get_hex_project_runs) - 执行 Hex 项目 (
run_hex_project) - 取消正在运行的项目 (
cancel_hex_run)
适用场景
- 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: 取消正在运行的项目
常见问题解答
- 安装后如何确认是否正常工作？
运行
hex-mcp --version确认版本信息。 - 如何配置 API 密钥？
使用
hex-mcp config --api-key "your_hex_api_key"或设置环境变量HEX_API_KEY。
使用教程
使用依赖
无特殊依赖，直接安装即可。
安装教程
推荐使用 uv 安装：
uv add hex-mcp
或使用 pip：
pip install hex-mcp
调试方式
安装完成后，运行以下命令确认版本信息：
hex-mcp --version
配置 API 密钥：
hex-mcp config --api-key "your_hex_api_key" --api-url "https://app.hex.tech/api/v1"
或设置环境变量：
export HEX_API_KEY="your_hex_api_key"
export HEX_API_URL="https://app.hex.tech/api/v1"
与 Cursor 集成
在项目根目录创建 .cursor/mcp.json 文件，内容如下：
{
"mcpServers": {
"hex-mcp": {
"command": "uv",
"args": ["run", "hex-mcp", "run"]
}
}
}
或直接使用 hex-mcp 命令：
{
"mcpServers": {
"hex-mcp": {
"command": "hex-mcp",
"args": ["run"]
}
}
}