🚀 Uptime Agent MCP Server

🚀 Uptime Agent MCP 服务

通过模型上下文协议（MCP），将您的 Uptime Agent 监控系统直接连接到 Claude 等 AI 助手。

✨ 功能

• 实时监控访问：允许 AI 助手检查系统的正常运行状态
• 事件管理：通过自然对话查看和分析停机事件
• 创建监控项：通过简单的语音或文本命令设置新的监控端点
• 安全集成：为您的监控基础设施提供企业级安全保障

🔍 什么是 Uptime Agent？

Uptime Agent 是一款功能强大的监控解决方案，可跟踪您的网站和 API 端点，并在它们发生故障时向您发出提醒。此 MCP 服务扩展了 Uptime Agent 的功能，让您可以通过 AI 助手与监控系统交互。

🛠️ 安装

前提条件

• Node.js 18 或更高版本
• 有效的 Uptime Agent 账户
• 您的 Uptime Agent API 密钥

获取 Uptime Agent API 密钥：

1. 登录您的 Uptime Agent Dashboard
2. 前往 Account → API Keys
3. 创建具有适当权限的新 API 密钥
4. 复制生成的密钥，以便在 MCP 服务中使用

选项 1：通过 NPM 快速安装（推荐）

最快的入门方式是使用我们的设置命令：

npx uptime-agent-mcp setup

此命令将：

• 安装 MCP 服务
• 配置其以便与 Claude Desktop 配合使用
• 提示您输入 Uptime Agent API 密钥
• 自动完成所有必要配置

选项 2：通过 Smithery.ai 安装

使用 Smithery.ai 安装：

1. 在 smithery.ai 创建账户
2. 从您的 Smithery 账户获取个人密钥
3. 运行以下命令：

npx -y @smithery/cli@latest install @AVIMBU/uptime_agent_mcp --client claude --key <personal_key>

将 <personal_key> 替换为您的实际 Smithery 个人密钥。

选项 3：手动本地安装

适合希望获得更多控制权的高级用户：

# Clone the repository
git clone https://github.com/AVIMBU/uptime_agent_mcp.git
cd uptime_agent_mcp

# Install dependencies
npm install

# Build the project
npm run build

创建 .env 文件并使用您的 API 密钥进行配置：

UPTIME_API_KEY=your-api-key-here
PORT=3000  # Optional, defaults to 3000

启动服务：

npm start
# or directly with
node dist/index.js

🤖 AI 助手集成

在 Claude Desktop 中设置

使用上述任一方法安装后，MCP 服务会自动配置为供 Claude Desktop 使用。

如果您是手动安装的，请将以下内容添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "uptime-agent": {
      "command": "npx",
      "args": [
        "-y",
        "uptime-agent-mcp"
      ],
      "env": {
        "UPTIME_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

或者，您也可以使用 Docker：

{
  "mcpServers": {
    "uptime-agent": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "UPTIME_API_KEY",
        "uptime-agent-mcp"
      ],
      "env": {
        "UPTIME_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

对话示例

检查监控项：

“Claude，显示我所有正在运行的正常运行时间监控项。”

创建新的监控项：

“请为我们的 API 端点 https://api.mycompany.com/v2/health 创建一个新的监控项。”

分析事件：

“上周我们的生产服务器发生了哪些事件？平均停机时间是多少？”

📊 可用功能

监控操作

功能	描述	参数
listMonitors	获取所有监控端点的完整列表	无需参数
getMonitor	获取特定监控项的详细信息	id：监控项标识符
createMonitor	设置要监控的新端点	name：监控项名称 url：要监控的 URL tracking_type：监控类型（http、ping 等） check_frequency：检查间隔（秒）

事件管理

功能	描述	参数
listIncidents	查看所有检测到的停机事件	无需参数
getIncident	获取特定事件的详细信息	id：事件标识符
listIncidentsByMonitor	查看特定端点的所有事件	monitor_id：监控器标识符

公开跟踪

功能	描述	参数
createAnonymousTracking	无需身份验证即可创建公开跟踪	url：要监控的 URL name：（可选）跟踪名称

与 Slack 集成（即将推出）

功能	描述	参数
slack_get_users	列出已连接的 Slack 工作区中的所有用户	limit：用户数量上限 cursor：分页游标
slack_post_message	向 Slack 发布通知	channel_id：要发布到的频道 text：消息内容

🐳 Docker 部署

我们提供 Docker 支持，便于部署：

# Build the Docker image
docker build -t uptime-agent-mcp .

# Run the container
docker run -p 3000:3000 -e UPTIME_API_KEY=your-api-key uptime-agent-mcp

📬 支持

如果您有疑问或需要帮助：

• 在 GitHub 上提交问题
• 通过我们的网站联系我们：AVIMBU

📜 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

---

由 AVIMBU 用 ❤️ 开发