H3 CLI MCP 服务器
MCP 服务器允许 AI 助手和 LLM 使用官方h3-cli
工具与 Horizon3.ai API 进行交互。
这是什么?
此 MCP 服务器将h3-cli的全部功能开放给您的 AI 编程助手(Claude、Cursor、VS Code 等)。它支持:
- 安排和运行渗透测试
- 查询渗透测试结果、弱点、影响、主机、凭证等
- 自动化安全工作流程和报告
- 全部通过自然语言和 LLM 工具
**注意:**您必须在系统上安装并验证有效的h3-cli
服务。此服务器是一个精简的封装程序,不管理您的 API 密钥或 CLI 安装。
快速复制粘贴:添加到您的 MCP 客户端
将其添加到您的 MCP 客户端配置(例如,Cursor、Claude Desktop、Windsurf 等):
{
"mcpServers": {
"h3": {
"command": "uvx",
"args": ["horizon3ai/h3-cli-mcp"]
}
}
}
- 无需手动克隆或构建此 repo -
uvx
将自动获取并运行最新版本。 - 对于高级用法,请参见下文。
特征
- 完整的 h3-cli API 访问:使用 CLI 可以做的所有事情,都可以通过 LLM 工具完成。
- GraphQL 文档:获取所有可用查询和变异的最新文档。
- 参数验证:清除所有工具输入的错误消息和示例。
- 提示模板:内置分页、数据透视和常见工作流程的指导。
- 可与任何 MCP 兼容客户端配合使用:Claude、Cursor、Windsurf、VS Code 等。
提供的工具
工具名称 | 描述 |
---|
run_h3_command | 运行任何 h3-cli 命令并返回输出。 |
fetch_graphql_docs | 获取任何查询、变异或类型的 GraphQL 模式/文档。 |
run_graphql_request | 运行带有变量的原始 GraphQL 查询并获取结果。 |
health_check | 检查 h3-cli 安装和 API 连接。 |
请参阅客户端的工具发现 UI 以获取完整的参数详细信息和示例。
与 VS Code、Cursor、Claude Desktop 等一起使用。
- VS Code :将上述配置添加到您的
.vscode/mcp.json
或用户设置(JSON)。 - Cursor :添加到
~/.cursor/mcp.json
或项目的.cursor/mcp.json
。 - Claude 桌面:添加到
claude_desktop_config.json
。 - Windsurf :添加到您的 Windsurf MCP 配置文件。
有关更多详细信息,请参阅客户端关于 MCP 服务器配置的文档。
故障排除
- 如果您看到有关未找到
h3
的错误,请确保您已安装并验证了h3-cli
(见下文)。 - 如果您看到身份验证错误,请在 CLI 中仔细检查您的 API 密钥。
- 如需更多帮助,请参阅官方 h3-cli 设置指南。
执照
MIT 许可证
1. 安装 h3-cli
git clone https://github.com/horizon3ai/h3-cli
cd h3-cli
bash install.sh your-api-key-here
- 从 Horizon3.ai 门户的用户 → 帐户设置下获取您的 API 密钥。
- 安装脚本将提示您更新 Shell 配置文件。请按照说明操作,然后重新启动终端。
2. 测试你的 h3-cli 安装
您应该会看到 h3-cli 帮助文本。
3. 验证您的 API 连接
您应该会看到如下响应:
{ "data": { "hello": "world!" } }