Devhelm Mcp Server

DevHelm MCP サーバー

Model Context Protocol（MCP）サーバーであるDevHelmを使うと、AI コーディングアシスタント（Cursor、Claude Desktop、Windsurf など）から稼働時間モニター、インシデント、アラートなどにアクセスできます。

クイックスタート

ホスト型（推奨）

ホスト型サーバー mcp.devhelm.io を使用します。接続モードは 2 種類あります。

Bearer 認証：

URL: https://mcp.devhelm.io/mcp
Authorization: Bearer <your-api-token>

URL 内の API キー（URL のみを受け付けるクライアント向け）：

URL: https://mcp.devhelm.io/<your-api-token>/mcp

ローカル（stdio）

pip install devhelm-mcp-server
export DEVHELM_API_TOKEN=your-token
devhelm-mcp-server

または uvx を使用します（インストール不要）：

export DEVHELM_API_TOKEN=your-token
uvx devhelm-mcp-server

Cursor / Claude Desktop

MCP 設定に追加します：

{
  "mcpServers": {
    "devhelm": {
      "url": "https://mcp.devhelm.io/<your-api-token>/mcp"
    }
  }
}

利用可能なツール

カテゴリ	ツール
モニター	一覧、取得、作成、更新（BROWSER / MULTI_STEP_API 用のインライン code）、削除（確認が必要）、復元、ゴミ箱、 一時停止、再開、ミュート、ミュート解除、隔離、隔離解除、ドリフト、バージョン、履歴（list_monitor_results は 2027-01-31 まで非推奨のエイリアス）
コードチェック	テスト、プローブ、アドホックテスト、今すぐ実行、トリガー；リビジョンの一覧、取得、ファイル、下書き作成、テスト、差分、破棄；公開とロールバック（確認が必要）、ロールバックのプレビュー
実行	取得（実行エンベロープ、wait_s ≤ 25）、一覧、ステップ、コンソール、ネットワーク、アーティファクト（スクリーンショットは画像、トレース/HAR は署名付き URL）、トレースの概要、差分、キャンセル
アカウント	ランタイムの一覧／取得、使用状況、権限
インシデント	一覧、取得、作成、更新、確認、更新情報の追加、解決、実行、イベント、関連項目、トリガー；プロンプト investigate_incident
アラートチャネル	一覧、取得、作成、更新、削除、テスト
通知ポリシー	一覧、取得、作成、更新、削除、テスト
環境	一覧、取得、作成、更新、削除
シークレット	一覧、値の設定、作成、更新（値はチャットに記載せず、エリシテーションまたはダッシュボードリンクを使用）、削除
タグ	一覧、取得、作成、更新、削除
リソースグループ	一覧、取得、作成、更新、削除、メンバーの追加、メンバーの削除
Webhook	一覧、取得、作成、更新、削除、テスト
API キー	一覧、作成、失効、削除
依存関係	一覧、取得、追跡、削除
デプロイロック	取得、現在の状態、解除、強制解除
ステータス	概要
ステータスページ	ページ、コンポーネント、グループ、インシデント、メンテナンス、サブスクライバー、ドメイン
メールテスト	アドレスの作成、待機（≤25 秒）、最新、メッセージの一覧／取得、ソース、OTP コード、リンク、注入；ドメインの一覧、取得、作成、更新、確認、アクティビティ
Webhook テスト	受信トレイの一覧、取得、作成、更新、アクティビティ；待機（≤25 秒）、最新、イベントの一覧／取得

削除、公開、ロールバックでは、最初に {status: "confirmation_required", changes, confirmationToken} が返されます。ユーザーが同意した後、confirmation_token を指定して再度呼び出してください。トークンはサーバープロセスが署名する HMAC です（すべてのレプリカで同じキーを共有するには DEVHELM_MCP_CONFIRMATION_SECRET を設定してください）。有効期間は 15 分です。エラーは isError とともに、すべての ErrorResponse フィールドとエージェント向けの一文を含めて返されます。

開発

uv sync
make dev          # Start with MCP Inspector (stdio)
make serve        # Start HTTP server on :8000
make test         # Run unit tests
make lint         # Check formatting
make typecheck    # Run mypy

ライセンス

MIT