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 日前通知でドメインモニターに追加してください」

迷惑メールに振り分けられたメールや、フィルターで除外された SMS 通知を探し回る必要はもうありません。質問するだけです。

---

提供されるツール

ツール	説明
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 とセッションクッキーのフローが使用されます。

1. GET https://api.domain-monitor.io/sanctum/csrf-cookie → XSRF-TOKEN と domain_monitor_session のクッキーを設定します
2. {email, password} と X-XSRF-TOKEN ヘッダーを指定して POST https://api.domain-monitor.io/login を実行し、認証します
3. 以降の https://api.domain-monitor.io/api/* へのリクエストでは、セッションクッキーと更新された 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 から確認）。

---

貢献

プルリクエストを歓迎します！今後の改善案をいくつかご紹介します。

• 稼働時間モニターのクエリへの対応
• Webhook／通知設定の管理
• ドメイン利用可能性チェッカーへの対応
• 監視対象からのドメイン削除（意図的に未対応です。破壊的な操作はウェブ UI から行うべきです）

domain-monitor.io の開発者の方で、公式の API トークン対応を追加したい場合は、このプロジェクトでもぜひ採用したいと考えています。お気軽に issue を作成してください！

---

トラブルシューティング

詳しいトラブルシューティング、再インストールの手順、アーキテクチャに関する説明については、OPS.md をご覧ください。

---

免責事項

このプロジェクトは domain-monitor.io とは提携しておらず、同社の推奨や公式サポートを受けていません。ブラウザーのネットワーク通信をリバースエンジニアリングして作成されました。ご利用は自己責任でお願いします。API は予告なく変更される場合があります。

ライセンス

MIT - Jason C Braatz