Pagerduty MCP Server

🚀 分页Duty サーバーサイド

PagerDuty Serverは、PagerDuty APIとやり取りするためのPythonクライアントライブラリです。PagerDutyからデータを取得するプロセスを簡素化し、データの処理と分析を支援するためのさまざまなツールを提供します。

🚀 クイックスタート

PagerDuty Serverを使って、PagerDuty APIとのやり取りを始めましょう。以下に基本的な使い方を示します。

✨ 主な機能

• ページング：PagerDuty APIのページングを自動的に処理し、大量のデータを簡単に取得できます。
• ユーザーコンテキスト：現在のユーザーコンテキストに基づいて結果をフィルタリングし、より関連性の高いデータを提供します。
• 複数のリソースサポート：イベント、チーム、サービス、ポリシーなど、複数のリソースタイプをサポートしています。

📦 インストール

pipを使ってインストールします。

pip install pagerduty-mcp-server

💻 使用例

基本的な使用法

ページングの例

すべてのイベントのページングを取得します。

from pagerduty_mcp_server import incidents
incidents = incidents.get_all_incidents()
for incident in incidents:
    print(incident.id)

イベント機能

イベントの一覧表示

現在のユーザーのチーム内のすべてのイベントを一覧表示します。

incidents_list = incidents.list_incidents()

# 特定のサービスのイベントを一覧表示
service_incidents = incidents.list_incidents(service_ids=['SERVICE-1', 'SERVICE-2'])

# 状態でイベントをフィルタリング
active_incidents = incidents.list_incidents(statuses=['triggered', 'acknowledged'])

時間範囲でのフィルタリング

時間範囲に基づいてイベントをフィルタリングします。

date_range_incidents = incidents.list_incidents(
    since='2024-03-01T00:00:00Z',
    until='2024-03-14T23:59:59Z'
)

イベントコンテキスト

current_user_context=Trueの場合、自動的に現在のユーザーに関連するチームとサービスをフィルタリングします。

my_incidents = incidents.list_incidents(current_user_context=True)

ユーザーコンテキストの制限

• current_user_context=Trueの場合、以下のパラメータを使用できません。
  • user_ids
  • team_ids
  • service_ids

チーム機能

チームの一覧表示

すべてのチームを取得します。

teams = teams.list_teams()
for team in teams:
    print(team.id)

サービス機能

サービスの一覧表示

特定のチームのサービスを一覧表示します。

services = services.list_services(team_id='TEAM-1')
for service in services:
    print(service.id)

コマンドラインツール

PagerDuty Serverは、一般的なタスクを実行するためのコマンドラインインターフェイス（CLI）を提供しています。

CLIのインストール

pipを使ってインストールします。

pip install pagerduty-mcp-server-cli

CLIの使用

すべてのイベントを一覧表示します。

pagerduty-server incidents list

特定のイベントの詳細情報を取得します。

pagerduty-server incidents get --id INCIDENT-123

📚 ドキュメント

開発

依存関係のインストール

開発用の依存関係をpipでインストールします。

pip install -r requirements.txt

テスト

単体テストを実行します。

pytest tests/

コードのコミット

Git Flowワークフローに従ってコミットしてください。

貢献ガイド

コミット規則

標準的なコミット規則に従い、コミット内容を明確かつ理解しやすくしてください。

リリースプロセス

poetryを使ってバージョン管理を行います。

poetry lock --no-update && poetry install

ドキュメントの作成

ドキュメントはdocs/ディレクトリにあり、Markdown形式で記述されています。

問題報告

問題が発生した場合は、GitHub Issuesで報告してください。

PagerDuty Serverは、PagerDuty APIとのやり取りをより効率的に行うための強力なツールです。このドキュメントがあなたの役に立つことを願っています！