使用说明
HostAtlas MCP服务器
MCP(模型上下文协议)服务器 HostAtlas --将您的基础设施监控连接到Claude Code、Cursor、Windsurf和任何兼容MCP的AI客户端。
管理服务器、检查警报、尾部日志、运行食谱和防御攻击——所有这些都是通过自然语言完成的。
免费注册 --无需信用卡。
快速开始
克劳德代码
claude mcp add hostatlas -- npx @hostatlas/mcp-server
设置API密钥:
export HOSTATLAS_API_URL=https://my.hostatlas.app
export HOSTATLAS_API_KEY=ha_your_api_key_here
Cursor/Windsurf/其他MCP客户端
添加到MCP配置中:
{
"mcpServers": {
"hostatlas": {
"command": "npx",
"args": ["@hostatlas/mcp-server"],
"env": {
"HOSTATLAS_API_URL": "https://my.hostatlas.app",
"HOSTATLAS_API_KEY": "ha_your_api_key_here"
}
}
}
}
自动配置(如果使用HostAtlas CLI)
如果你已经跑过了 hostatlas login,MCP服务器从以下位置读取您的配置 ~/.hostatlas/cli.json 自动——不需要环境变量。
配置
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
HOSTATLAS_API_URL |
是* | -- | 您的HostAtlas URL(例如。 https://my.hostatlas.app) |
HOSTATLAS_API_KEY |
是* | - | 设置>API密钥中的API密钥 |
*如果满足以下条件,则不需要 ~/.hostatlas/cli.json 从CLI登录中存在。
可用工具(21)
平台
| 工具 | 说明 |
|---|---|
get_status |
平台概述:服务器计数、触发警报、未解决事件 |
服务器
| 工具 | 说明 |
|---|---|
list_servers |
列出所有服务器,包括主机名、IP、状态、运行状况评分 |
get_server |
获取详细的服务器信息,包括服务、指标、标签 |
restart_service |
重启服务器上的服务(nginx、mysql、redis等) |
run_audit |
使用优化建议运行服务审核 |
警报和事件
| 工具 | 说明 |
|---|---|
list_alerts |
列出射击和最近的警报事件 |
acknowledge_alert |
确认射击警报 |
list_incidents |
列出未解决的事件 |
create_incident |
创建手动事件 |
域和监视器
| 工具 | 说明 |
|---|---|
list_domains |
列出具有SSL状态、HTTP运行状况和响应时间的域 |
list_monitors |
列出正常运行时间监视器的状态和响应时间 |
list_heartbeats |
列出心跳/定时监视器的最后ping时间 |
运营
| 工具 | 说明 |
|---|---|
request_logs |
从远程服务器请求日志行 |
list_recipes |
列出可用的自动化配方 |
run_recipe |
在服务器上执行配方 |
备份
| 工具 | 说明 |
|---|---|
list_backup_paths |
列出服务器的备份监视路径 |
update_backup_paths |
设置备用监视路径 |
list_offsite_backups |
列出已完成的异地备份 |
restore_offsite_backup |
触发异地备份的还原 |
攻击模式
| 工具 | 说明 |
|---|---|
get_attack_mode_status |
检查攻击模式是否处于活动状态,获取实时指标 |
activate_attack_mode |
激活攻击模式(增强监控+DDoS防御) |
deactivate_attack_mode |
停用攻击模式 |
资源(3)
MCP资源提供只读上下文,AI客户端可以将其拉入上下文窗口。
| 资源 | URI | 描述 |
|---|---|---|
| 平台状态 | hostatlas://status |
服务器计数、警报/事件计数 |
| 服务器列表 | hostatlas://servers |
所有具有运行状况和状态的服务器 |
| 活动警报 | hostatlas://alerts |
当前发出警报 |
对话示例
“我的服务器怎么样了?”
→ AI呼叫 get_status,看到2个警报发出,呼叫 list_alerts 详情
“在prod-01上重新启动nginx”
→ AI呼叫 list_servers 要查找UUID,则 restart_service
“我们受到攻击了吗?”
→ AI呼叫 get_attack_mode_status 对于每台关键服务器
“显示web-02上nginx错误日志的最后200行”
→ AI呼叫 request_logs 与文件 /var/log/nginx/error.log 线200
“在所有临时服务器上运行系统更新配方”
→ AI呼叫 list_servers 为了找到临时服务器, list_recipes 找到食谱,然后 run_recipe 对于每一个
需求
- Node.js 18+
- 带有API密钥的HostAtlas帐户
安全
- API密钥通过
Authorization: Bearer仅通过HTTPS发送标头 - MCP服务器不存储凭据
- 配置文件(
~/.hostatlas/cli.json)有0600权限(由CLI设置) - 所有修改状态(重启、攻击模式等)的工具都需要在AI客户端中进行明确的用户确认
许可证
MIT许可证
建造于 Akyros实验室有限责任公司 — hello@akyroslabs.com
