Cursor/AI 助手用自然语言操作监控与告警
主要用途
- 告警管理：查询活跃告警和历史告警，查看告警规则和订阅
- 目标监控：浏览和搜索被监控的主机，分析目标状态
- 事件响应：创建和管理告警屏蔽规则、通知规则和事件流水线
- 团队协作：查询用户、团队和业务组
快速开始
1.获取 API Token
- 确保在 config.toml 中，启用了 HTTP.TokenAuth
[HTTP.TokenAuth] Enable = true- 登录夜莺 Web 界面
- 进入个人设置>个人信息>Token 管理
- 创建一个具有适当权限的新 Token
安全提示：请妥善保管 API Token。切勿将 Token 提交到版本控制系统。请使用环境变量或安全的密钥管理系统。
2.与 MCP 客户端配合使用
Cursor
在~/.cursor/mcp.json中添加：
{ "mcpServers": { "nightingale": { "command": "npx", "args": ["-y", "@n9e/n9e-mcp-server", "stdio"], "env": { "N9E_TOKEN": "your-api-token", "N9E_BASE_URL": "http://your-n9e-server:17000" } } } }3.重启 OpenCode 等进程，即可使用
可用工具
| 工具集 | 工具 | 说明 |
|---|---|---|
| alerts | list_active_alerts | 列出当前活跃告警，支持过滤条件 |
| alerts | get_active_alert | 根据事件 ID 获取活跃告警详情 |
| alerts | list_history_alerts | 列出历史告警，支持过滤条件 |
| alerts | get_history_alert | 获取历史告警详情 |
| alerts | list_alert_rules | 列出业务组的告警规则 |
| alerts | get_alert_rule | 获取告警规则详情 |
| targets | list_targets | 列出被监控主机/目标，支持过滤条件 |
| datasource | list_datasources | 列出所有可用数据源 |
| mutes | list_mutes | 列出业务组的告警屏蔽规则 |
| mutes | get_mute | 获取告警屏蔽规则详情 |
| mutes | create_mute | 创建告警屏蔽规则 |
| mutes | update_mute | 更新告警屏蔽规则 |
| notify_rules | list_notify_rules | 列出所有通知规则 |
| notify_rules | get_notify_rule | 获取通知规则详情 |
| alert_subscribes | list_alert_subscribes | 列出业务组的告警订阅 |
| alert_subscribes | list_alert_subscribes_by_gids | 列出多个业务组的订阅 |
| alert_subscribes | get_alert_subscribe | 获取订阅详情 |
| event_pipelines | list_event_pipelines | 列出所有事件流水线 |
| event_pipelines | get_event_pipeline | 获取事件流水线详情 |
| event_pipelines | list_event_pipeline_executions | 列出指定流水线的执行记录 |
| event_pipelines | list_all_event_pipeline_executions | 列出所有流水线的执行记录 |
| event_pipelines | get_event_pipeline_execution | 获取执行记录详情 |
| users | list_users | 列出用户，支持过滤条件 |
| users | get_user | 获取用户详情 |
| users | list_user_groups | 列出用户组/团队 |
| users | get_user_group | 获取用户组详情（包含成员） |
| busi_groups | list_busi_groups | 列出当前用户可访问的业务组 |
示例提示词
配置完成后，您可以使用自然语言与夜莺交互：
- "显示过去 24 小时内所有紧急告警"
- "当前有哪些告警正在触发？"
- "列出所有离线超过 5 分钟的监控目标"
- "业务组 1 配置了哪些告警规则？"
- "由于维护原因，为 service=api 的告警创建一个 2 小时的屏蔽规则"
- "查看事件流水线的执行历史"
- "运维团队有哪些成员？"
配置
环境变量
| 变量 | 命令行参数 | 说明 | 默认值 |
|---|---|---|---|
N9E_TOKEN | --token | 夜莺 API Token（必需） | - |
N9E_BASE_URL | --base-url | 夜莺 API 地址 | http://localhost:17000 |
N9E_READ_ONLY | --read-only | 禁用写操作 | false |
N9E_TOOLSETS | --toolsets | 启用的工具集（逗号分隔） | all |
工具集选择
默认启用所有工具集。可以通过--toolsets参数或N9E_TOOLSETS环境变量只启用需要的工具集，减少暴露给 AI 助手的工具数量，节省上下文窗口的 token 消耗。
可用工具集：alerts、targets、datasource、mutes、busi_groups、notify_rules、alert_subscribes、event_pipelines、users
例如，只启用告警和监控目标相关工具：
{ "mcpServers": { "nightingale": { "command": "npx", "args": ["-y", "@n9e/n9e-mcp-server", "stdio"], "env": { "N9E_TOKEN": "your-api-token", "N9E_BASE_URL": "http://your-n9e-server:17000", "N9E_TOOLSETS": "alerts,targets" } } } }