🚀 Uptime Agent MCP Server

🚀 Uptime Agent MCP Server

Model Context Protocol（MCP）を通じて、Uptime Agent の監視システムを Claude などの AI アシスタントに直接接続できます。

✨ 機能

• リアルタイムの監視状況へのアクセス：AI アシスタントがシステムの稼働状況を確認できます
• インシデント管理：自然な会話を通じて、ダウンタイムのインシデントを表示、分析できます
• モニターの作成：簡単な音声またはテキストコマンドで、新しい監視エンドポイントを設定できます
• セキュアな連携：監視インフラストラクチャにエンタープライズグレードのセキュリティを提供します

🔍 Uptime Agent とは？

Uptime Agent は、ウェブサイトや API エンドポイントを監視し、停止した際にアラートを送信する強力な監視ソリューションです。この MCP サーバーを使うと、AI アシスタントを通じて監視システムを操作できるようになり、Uptime Agent の機能が拡張されます。

🛠️ インストール

前提条件

• 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、アクティブな稼働状況モニターをすべて表示してください。」

新しいモニターの作成：

「https://api.mycompany.com/v2/health にある API エンドポイントの新しいモニターを作成してください。」

インシデントの分析：

「先週、本番サーバーでどのようなインシデントが発生しましたか？平均ダウンタイムも教えてください。」

📊 利用可能な機能

モニター操作

関数	説明	パラメーター
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 が ❤️ を込めて開発しました。AVIMBU