InfraNest

infranest-mcp

向 AI 助手询问你的基础设施情况。
哪些服务宕机了、主机名指向哪里、哪些项目即将到期、谁做了哪些更改。托管服务，无需安装。

---

InfraNest 集中管理你在现有云服务商和 DNS 服务商处的服务器、运行时间监控、事件、DNS、域名和证书。这是它托管的 模型上下文协议服务。你可以用日常语言询问：现在有哪些服务宕机了、昨晚哪些监控失败了、主机名指向哪里、哪些域名和证书即将到期、哪些服务器的磁盘空间即将耗尽，以及审计日志中谁做了哪些更改。

https://api.infranest.io/mcp

它只读取信息，并且只会执行你允许的更改。 除少数值班工具外，其他工具都只读取信息。值班工具包括确认事件、给团队留言、静默监控、重新检查监控，以及开始或结束维护时段；使用这些工具需要 Monitoring 的写入权限：拥有 Monitoring 写入权限的 API 令牌，或在连接时勾选 也允许它执行操作。每项更改都可以通过另一项操作撤销，并会记录在审计日志中；助手会在执行前征求你的确认。除此之外，无法创建、更改或删除任何内容，也不会返回域名转移码、私钥或令牌等机密信息。所有 InfraNest 套餐均可使用，包括 Free。

连接

支持登录（OAuth）的助手——Claude、ChatGPT、VS Code、Cursor 等：使用上方的 URL 添加自定义连接器，或点击上方按钮。使用 InfraNest 账号登录，并选择允许它使用的一个组织；它只能查看你在该组织角色权限范围内的内容。你可以随时在我的账户 → 已授权的应用中移除连接。

需要使用请求头的助手——在 InfraNest 中创建 API 令牌（我的账户 → 开发者），并将其作为 bearer 令牌发送：

{
  "mcpServers": {
    "infranest": {
      "url": "https://api.infranest.io/mcp",
      "headers": { "Authorization": "Bearer <your InfraNest API token>" }
    }
  }
}

Gemini CLI——此仓库是一个 Gemini CLI 扩展：

gemini extensions install https://github.com/InfraNest-Infrastructure-Organized/infranest-mcp

Gemini CLI 首次使用工具时会打开 InfraNest 登录页面。

还没有账号？在 infranest.io 免费注册。你可以使用包含示例数据的 沙盒安全地试用所有工具。

各助手的分步设置说明：developers.infranest.io/ai-assistants。

工具

工具	可查询内容
list_organizations	你可以读取哪些组织
status_overview	目前一切是否正常运行——监控项、服务器、未解决事件和正在进行的维护
status_across_organizations	你的组织中是否有任何服务宕机，每个组织一行
search、fetch	按名称查找，然后完整读取你要查看的内容
list_servers、get_server	你的云服务器，可按状态、提供商或标签筛选
server_attention	服务器上有哪些问题需要关注
server_metrics、server_metric_history	服务器最新的 CPU、内存和磁盘数据，以及某台服务器随时间变化的数据
list_monitors、get_monitor	你的运行时间监控项
monitor_stats、monitor_results	某个监控项的运行时间和响应时间，以及最近的检查结果
list_incidents、incident_timeline	事件及其经过
list_deploys、deploy_changes	部署到监控项或服务器的记录，以及每次部署的更改
list_dns_zones、list_dns_records	DNS 区域及其记录
search_dns、check_dns_name	主机名在所有区域中的指向，以及某个名称的所有信息，包括实时 DNS
dns_zone_changes、dns_outside_changes	区域最近的更改，包括在 InfraNest 中进行的更改，以及直接在 DNS 提供商处进行的更改
list_domains、domain_findings	域名的到期和续订状态，以及其中任何域名的问题，一次调用即可查询
list_certificates	证书及其到期时间
list_status_pages	你的公开状态页
list_dynamic_ips	动态 IP 及其持续更新的记录
list_maintenance_windows	计划维护
search_audit_log	谁在何时更改了什么
uptime_report	月度运行时间报告
read_api	公开 API 中的其他读取操作

值班操作，仅限拥有 Monitoring 写入权限时使用：

工具	功能	可撤销操作
acknowledge_incident、unacknowledge_incident	将事件标记为由你负责，停止重复告警并通知团队	彼此
add_incident_note	为事件添加团队备注	—
silence_monitor、unsilence_monitor	暂时停止监控项的告警；监控项仍会继续检查	彼此
run_monitor_check	立即重新检查监控项，而不是等待其计划时间	—
start_maintenance、end_maintenance	开始维护时段，避免计划内工作触发通知，并在结束时关闭维护时段。默认仅内部可见；如果提供公开通知，则会显示在你的状态页上	彼此

提示词

助手提示词菜单中的现成问题：

提示词	可获取内容
健康检查（health_check）	目前有哪些服务宕机，以及本月有哪些事项需要关注：事件、服务器、域名、证书、DNS
调查事件（investigate_incident）	服务宕机的原因：事件本身、受影响的内容、宕机前刚发生的更改，以及接下来该怎么做
最近有哪些更改（what_changed）	某个时间段内的所有更改：设置、部署、在 InfraNest 中以及 DNS 提供商处进行的 DNS 编辑
月度运行时间报告（monthly_report）	可直接发送给客户的报告：相对于目标值的运行时间、每个事件及其原因、计划维护

此仓库包含什么

服务本身由 InfraNest 托管；其源代码不在这里。此仓库包含 MCP 客户端和目录会读取的相关信息：

文件	读取方
server.json	官方 MCP Registry，其中条目为 io.infranest/infranest
gemini-extension.json、GEMINI.md	Gemini CLI 及其扩展库
此 README	你，以及列出该服务的 MCP 目录

每次更改时，CI 都会检查这些文件是否符合 Registry 的架构定义，以及彼此是否一致；此外，每周还会检查上方的工具表是否与在线服务描述的工具一致。

链接

• 在开发者网站上查看通过 AI 助手使用 InfraNest，帮助中心也提供相同内容
• 开发者文档和 API 参考
• infranest-openapi：API 描述
• infranest-examples：可直接运行的 API 脚本
• 服务状态
• 隐私政策 · 服务条款

发现问题？请提交 issue，或发送邮件至 [email protected]。若发现 InfraNest 的安全问题，请参阅 infranest.io/security。

许可证

此仓库中的文件采用 Apache License 2.0。你对 InfraNest 的使用受其服务条款约束。