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_hereCursor/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
