Xitoring Mcp

Xitoring MCP 服务

将 Claude、Cursor 和 ChatGPT 等 AI 助手连接到你的 Xitoring 监控数据。

Xitoring MCP 服务是一个托管式远程 HTTP 服务，无需在本地安装或运行任何内容。使用你的 Xitoring API 密钥，将 MCP 兼容客户端指向 https://app.xitoring.com/mcp 即可。

什么是 Xitoring？

Xitoring 是一个一站式监控平台：正常运行时间检查（HTTP、TCP、DNS、ICMP）、通过 Xitogent Agent 进行服务器监控（CPU、内存、磁盘、网络、进程）、SSL 过期检查、心跳检查、事件管理、状态页面和通知路由。团队使用它来检测服务中断、排查性能回退、跟踪 SLA 并执行值班工作。

MCP 服务能做什么

该服务提供涵盖以下领域的 60 多种工具：

服务器与指标

检查服务器和 Xitogent Agent，获取实时和历史 CPU / 内存 / 磁盘 / 网络指标，列出占用资源最多的进程，并获取系统信息。

正常运行时间、SSL 与心跳

列出并检查各种类型的检查（HTTP、HTTPS、TCP、DNS、ICMP、SSL、心跳）。获取响应时间、延迟、区域可达性和正常运行时间百分比。

事件与告警

搜索和筛选事件，查看事件时间线和备注，检查触发器和通知路由，并跟踪事件状态变化。

状态页面与维护

查看状态页面及其展示的组件，列出当前和即将开始的维护窗口。

报告与账户

获取正常运行时间和 SSL 报告，查看订阅和配额使用情况，列出并查看支持工单。

审计日志

账户级审计日志、Xitogent 连接 / 安装日志，以及通知送达历史记录。

写入操作

解决事件、添加备注、暂停 / 恢复检查、创建新检查、安排维护、发送测试通知、邀请联系人，以及提交支持工单。

前置条件

• 一个 Xitoring 账户（免费套餐可用于试用）
• 一个 Xitoring API 密钥——前往 Dashboard > Account > API Access > Generate Key 生成。文档：xitoring.com/docs/account/api
• 一个 MCP 兼容客户端（Claude Code、Claude Desktop、Cursor、集成 Copilot 的 VS Code 等）

设置

选择与你的客户端对应的部分。在以下每个示例中，将 YOUR_API_KEY 替换为你在上方生成的密钥。

Claude Code CLI（最快）

claude mcp add --transport http --scope user xitoring \
  https://app.xitoring.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

编辑配置文件：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "xitoring": {
      "type": "http",
      "url": "https://app.xitoring.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

保存后重启 Claude Desktop。

Cursor

Settings > MCP > Add new MCP server，然后粘贴：

{
  "mcpServers": {
    "xitoring": {
      "url": "https://app.xitoring.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code（GitHub Copilot）

在工作区中创建 .vscode/mcp.json：

{
  "servers": {
    "xitoring": {
      "type": "http",
      "url": "https://app.xitoring.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

仅支持 Stdio 的客户端（通过 mcp-remote 桥接）

如果你的客户端仅支持 stdio 传输，可通过 mcp-remote 进行桥接：

{
  "mcpServers": {
    "xitoring": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.xitoring.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

验证连接

1. 重启 MCP 客户端。
2. 打开工具 / 服务选择器——你应该能看到列有相关工具的 xitoring。
3. 试试这个提示词：“列出我的 Xitoring 服务器及其当前状态。”

如果返回结果中显示了你的真实服务器名称，就说明连接成功。

示例提示词

状态与排查

• “目前有哪些事件仍在处理中？哪些服务器或检查受到影响？”
• “显示我所有服务器的当前状态——标出任何未上报状态的服务器。”
• “接下来的 24 小时内是否有正在进行或即将开始的维护窗口？”

性能与容量

• “目前 CPU 使用率最高的 5 台服务是什么？”
• “显示 web-prod-01 上内存占用最高的进程。”
• “按磁盘使用率对我的服务进行排名，并告诉我哪些服务的磁盘已使用超过 80%。”

正常运行时间与 SLA

• “过去 30 天内，我所有检查的总体正常运行时间是多少？”
• “哪些 SSL 证书将在未来 30 天内到期？”
• “调取 api.example.com 上个月的正常运行时间报告。”

事件响应

• “总结 db-01 上最近 3 起已解决事件，并读出事件备注。”
• “根据事件 #1234 的时间线起草一份事后分析。”
• “为当前事件添加备注：‘正在回滚部署 v2.41，监控恢复情况。’”

维护与运维

• “为 web-prod-01 创建一项 2 小时的维护计划，从明天 02:00 UTC 开始。”
• “在我们重新部署期间，暂停对 staging.example.com 的正常运行时间检查。”
• “为 https://api.example.com/health 创建一项 HTTP 检查，每分钟从 EU 区域运行一次。”

安全与隐私

• 所有发往 https://app.xitoring.com/mcp 的流量均通过 HTTPS 加密。
• 身份验证使用 Xitoring API 密钥，并通过 Authorization: Bearer ... 传递。在 Xitoring 控制面板中撤销密钥后，MCP 访问权限会立即被切断。
• 生产账户的密钥每 90 天轮换一次；如果密钥泄露，则立即轮换。
• **请注意：**AI 客户端会将对话上下文（包括工具结果）发送给模型提供商。只有通过 MCP 工具明确请求的数据才会从 Xitoring 读取，但这些结果随后会成为模型提供商可见的对话内容。

故障排查

症状	检查内容
401 Unauthorized	API 密钥错误、已撤销，或请求头格式错误。请求头必须准确写为 Authorization: Bearer YOUR_API_KEY，不能有多余的引号或拼写错误。
客户端中未显示 MCP 服务	完全重启客户端。验证 JSON 语法（缺少逗号会导致该条目被静默禁用）。
429 Too Many Requests	MCP 与 Xitoring 的 REST API 共用速率限制。降低提示词请求频率，或升级套餐。
工具返回空结果	检查 API 密钥的权限范围，以及当前是否处于正确的子账户上下文中。某些工具只会返回该密钥有权访问的数据。
工具调用挂起	检查 Xitoring 状态页面，然后重试。如果问题可以复现，请提交问题，并附上工具名称和时间戳。

链接

• 完整文档： xitoring.com/docs/mcp
• 生成 API 密钥： xitoring.com/docs/account/api
• Model Context Protocol： modelcontextprotocol.io

状态

Xitoring MCP 服务目前处于 beta 阶段。工具名称和响应格式可能会在 1.0 版本发布前发生变化。欢迎通过 GitHub issues 提交反馈和错误报告。

许可证

MIT