Domain Monitor

domain-monitor-mcp

一款非官方的 domain-monitor.io MCP（Model Context Protocol）服务，让 Claude 等 AI 助手无需浏览器即可直接查询你的域名到期数据。

注意：这是一个社区项目，并非由 domain-monitor.io 官方支持。它使用的是通过检查浏览器网络流量发现的内部 API。如果你是 domain-monitor.io 的开发者，并希望合作开发官方 MCP 服务或公共 API，请提交 issue——我们很乐意与你合作！

---

功能

安装后，你可以向 Claude 提出以下问题：

• “未来 30 天内有哪些域名到期？”
• “braatz.io 什么时候到期？”
• “概述一下域名的健康状况”
• “按到期日期排序，列出我的所有域名”
• “将 newdomain.com 添加到域名监控，并设置 60 天提醒”

再也不用翻找被归入垃圾邮件的邮件，或被过滤掉的短信提醒了。直接询问即可。

---

提供的工具

工具	说明
domain_monitor_get_expiring_soon	快速查看——在提醒期限内到期的域名
domain_monitor_list_domains	完整的分页列表，可选择按距离到期的天数筛选
domain_monitor_check_domain	按名称查询特定域名
domain_monitor_get_account_summary	账户统计信息、订阅状态和有效提醒
domain_monitor_add_domain	添加要监控的新域名，可配置提醒周期和监控开关

---

安装

前置要求

• Python 3.10+
• 一个 domain-monitor.io 账户（免费或付费）
• Claude Desktop（或任何兼容 MCP 的客户端）

1. 克隆此仓库

git clone https://github.com/jasoncbraatz/domain-monitor-mcp.git
cd domain-monitor-mcp

2. 安装依赖

pip install -r requirements.txt

也可以使用 uv（更快）：

uv pip install -r requirements.txt

3. 配置 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中：

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

{
  "mcpServers": {
    "domain-monitor": {
      "command": "python",
      "args": ["/absolute/path/to/domain-monitor-mcp/server.py"],
      "env": {
        "DOMAIN_MONITOR_EMAIL": "[email protected]",
        "DOMAIN_MONITOR_PASSWORD": "yourpassword"
      }
    }
  }
}

将 /absolute/path/to/domain-monitor-mcp/server.py 替换为你克隆此仓库时使用的实际路径。

4. 重启 Claude Desktop

保存配置后，完全退出并重新启动 Claude Desktop。domain-monitor 工具将显示在 Claude 的工具列表中。

---

身份验证

此服务通过 Laravel Sanctum 会话身份验证，使用你的 domain-monitor.io 邮箱和密码——与网站底层使用的机制相同。会话保存在内存中，并会在过期时自动刷新。

你的凭据绝不会保存到磁盘——它们仅存在于你在上方配置的环境变量中，并且只在服务运行期间保存在内存中。

---

工作原理（供好奇者 / 开发者参考）

domain-monitor.io 是一个由 Laravel API 支持的 Nuxt.js SPA。API 位于 https://api.domain-monitor.io/。身份验证遵循标准的 Laravel Sanctum CSRF + 会话 Cookie 流程：

1. GET https://api.domain-monitor.io/sanctum/csrf-cookie → 设置 XSRF-TOKEN + domain_monitor_session Cookie
2. POST https://api.domain-monitor.io/login，携带 {email, password} + X-XSRF-TOKEN 标头 → 完成身份验证
3. 后续向 https://api.domain-monitor.io/api/* 发送的请求会使用会话 Cookie + 刷新的 XSRF 令牌

使用的关键端点：

• GET /api/account — 账户信息 + 用户 ID
• GET /api/account-dashboard — 包含即将到期域名和提醒的概览
• GET /api/account/{user_id}/domains — 包含到期数据的分页域名列表
• POST /api/account/{user_id}/domains — 添加要监控的新域名

添加域名的 POST 负载需要包含以下字段：

{
  "domain": "example.com",
  "alert_period": 30,
  "certificate_checks_enabled": true,
  "dns_checks_enabled": true,
  "blacklist_checks_enabled": false
}

每个会话的 API 速率限制为 200 个请求（根据响应标头 x-ratelimit-limit 观察得出）。

---

贡献

欢迎提交 PR！未来改进的一些想法：

• 支持查询正常运行时间监控
• 管理 Webhook/通知偏好设置
• 支持域名可用性检查器
• 从监控中删除域名（有意不提供——破坏性操作应通过 Web UI 执行）

如果你是 domain-monitor.io 的开发者，并希望添加官方 API 令牌支持，本项目非常乐意采用——只需提交一个 issue！

---

故障排除

请参阅 OPS.md，了解详细的故障排除、重新安装步骤和架构说明。

---

免责声明

本项目与 domain-monitor.io 无关，也未获得其认可或官方支持。本项目通过逆向分析浏览器网络流量构建。使用风险自负。API 可能会在不另行通知的情况下发生变化。

许可证

MIT - Jason C Braatz