Skip to main content
Glama
enesjakozh

PagerDuty MCP Server

by wpfleger96
GitHub
Python
MIT License
2
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

PagerDuty MCP サーバー

PagerDuty API機能をLLMに公開するサーバー。このサーバーは、構造化された入出力を用いてプログラム的に使用できるように設計されています。

概要

PagerDuty MCPサーバーは、PagerDuty APIと連携するためのツールセットを提供します。これらのツールは、LLMがインシデント、サービス、チーム、ユーザーなどのPagerDutyリソースに対してさまざまな操作を実行するために使用できるように設計されています。

インストール

PyPIから

pip install pagerduty-mcp-server

ソースから

# Clone the repository git clone https://github.com/wpfleger96/pagerduty-mcp-server.git cd pagerduty-mcp-server # Install dependencies brew install uv uv sync

要件

  • Python 3.13以上
  • PagerDuty APIキー

構成

PagerDuty MCP サーバーでは、環境に PagerDuty API キーを設定する必要があります。

PAGERDUTY_API_KEY=your_api_key_here

使用法

グースエクステンションとして

{ "type": "stdio", "enabled": true, "args": [ "run", "python", "-m", "pagerduty_mcp_server" ], "commandInput": "uv run python -m pagerduty_mcp_server", "timeout": 300, "id": "pagerduty-mcp-server", "name": "pagerduty-mcp-server", "description": "pagerduty-mcp-server", "env_keys": [ "PAGERDUTY_API_KEY" ], "cmd": "uv" }

スタンドアロンサーバーとして

uv run python -m pagerduty_mcp_server

応答フォーマット

すべての API 応答は一貫した形式に従います。

{ "metadata": { "count": <int>, // Number of results "description": "<str>" // A short summary of the results }, <resource_type>: [ // Always pluralized for consistency, even if one result is returned { ... }, ... ], "error": { // Only present if there's an error "message": "<str>", // Human-readable error description "code": "<str>" // Machine-readable error code } }

エラー処理

エラーが発生すると、応答には次の構造のエラー オブジェクトが含まれます。

{ "metadata": { "count": 0, "description": "Error occurred while processing request" }, "error": { "message": "Invalid user ID provided", "code": "INVALID_USER_ID" } }

一般的なエラーのシナリオは次のとおりです。

  • 無効なリソース ID (例: user_id、team_id、service_id)
  • 必要なパラメータが不足しています
  • 無効なパラメータ値
  • APIリクエストの失敗
  • 応答処理エラー

パラメータ検証

  • すべてのIDパラメータは有効なPagerDutyリソースIDである必要があります
  • 日付パラメータは有効なISO8601タイムスタンプである必要があります
  • リストパラメータ（例： statuses 、 team_ids ）には有効な値が含まれている必要があります
  • リストパラメータ内の無効な値は無視されます
  • 必須パラメータはNoneまたは空の文字列にすることはできません
  • list_incidentsのstatusesの場合、有効な値はtriggered 、 acknowledged 、 resolvedのみです。
  • インシデントのurgencyについては、 highとlowのみが有効値です
  • limitパラメータはリスト操作によって返される結果の数を制限するために使用できます。

レート制限とページネーション

  • サーバーはPagerDutyのレート制限を尊重します
  • サーバーが自動的にページ区切りを処理します
  • limitパラメータはリスト操作によって返される結果の数を制御するために使用できます。
  • 制限が指定されていない場合、サーバーはデフォルトで最大{pagerduty_mcp_server.utils.RESPONSE_LIMIT}件の結果を返します。

使用例

from pagerduty_mcp_server import incidents from pagerduty_mcp_server.utils import RESPONSE_LIMIT # List all incidents (including resolved) for the current user's teams incidents_list = incidents.list_incidents() # List only active incidents active_incidents = incidents.list_incidents(statuses=['triggered', 'acknowledged']) # List incidents for specific services service_incidents = incidents.list_incidents(service_ids=['SERVICE-1', 'SERVICE-2']) # List incidents for specific teams team_incidents = incidents.list_incidents(team_ids=['TEAM-1', 'TEAM-2']) # List incidents within a date range date_range_incidents = incidents.list_incidents( since='2024-03-01T00:00:00Z', until='2024-03-14T23:59:59Z' ) # List incidents with a limit on the number of results limited_incidents = incidents.list_incidents(limit=10) # List incidents with the default limit default_limit_incidents = incidents.list_incidents(limit=RESPONSE_LIMIT)

ユーザーコンテキスト

多くの関数はcurrent_user_contextパラメータ（デフォルトはTrue ）を受け付けます。このパラメータは、このコンテキストに基づいて結果を自動的にフィルタリングします。current_user_context がTrueの場合、自動フィルタリングと競合するため、特定のフィルタパラメータは使用current_user_contextません。

  • すべてのリソース タイプの場合:
    • user_ids``current_user_context=Trueでは使用できません
  • インシデントの場合:
    • team_idsとservice_ids``current_user_context=Trueでは使用できません
  • サービスの場合:
    • team_ids``current_user_context=Trueでは使用できません
  • エスカレーション ポリシーの場合:
    • team_ids``current_user_context=Trueでは使用できません
  • オンコールの場合:
    • user_ids``current_user_context=Trueでは使用できません
    • schedule_ids特定のスケジュールでフィルタリングするために引き続き使用できます。
    • クエリは、現在のユーザーのチームに関連付けられているすべてのエスカレーション ポリシーのオンコールを表示します。
    • これは、「現在私のチームでオンコールになっているのは誰ですか?」などの質問に答えるのに役立ちます。
    • 現在のユーザーのIDはフィルターとして使用されないため、オンコール中のチームメンバー全員が表示されます。

発達

テストの実行

ほとんどのテストでは PagerDuty API への実際の接続が必要なので、完全なテスト スイートを実行する前に環境でPAGERDUTY_API_KEYを設定する必要があることに注意してください。

uv run pytest

ユニット テストのみ (つまり、環境でPAGERDUTY_API_KEY設定する必要のないテスト) を実行するには:

uv run pytest -m unit

統合テストのみを実行するには:

uv run pytest -m integration

パーサー テストのみを実行するには:

uv run pytest -m parsers

特定のサブモジュールに関連するテストのみを実行するには:

uv run pytest -m <client|escalation_policies|...>

MCP Inspector を使用したデバッグサーバー

npx @modelcontextprotocol/inspector uv run python -m pagerduty_mcp_server

貢献

リリース

このプロジェクトでは、自動リリースにConventional Commitsを使用しています。コミットメッセージによってバージョンアップが決定されます。

  • feat: → マイナーバージョンアップ (1.0.0 → 1.1.0)
  • fix: → パッチバージョン (1.0.0 → 1.0.1)
  • BREAKING CHANGE: → メジャーバージョン (1.0.0 → 2.0.0)

CHANGELOG.md、GitHub リリース、PyPI パッケージは自動的に更新されます。

ドキュメント

ツールドキュメント- パラメータ、戻り値の型、サンプルクエリなど、利用可能なツールに関する詳細情報

コンベンション

  • すべてのAPIレスポンスは、メタデータ、リソースリスト、およびオプションのエラーを含む標準形式に従います。
  • 応答内のリソース名は一貫性を保つために常に複数形になります
  • 単一の項目を返すすべての関数は、1つの要素を持つリストを返します。
  • エラー応答にはメッセージとコードの両方が含まれます
  • すべてのタイムスタンプはISO8601形式です
  • テストには、そのタイプ（ユニット/統合）、テスト対象のリソース（インシデント、チームなど）、解析機能をテストするかどうか（「パーサー」マーカー）を示す pytest マーカーが付けられます。
Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

構造化された入力と出力を使用して PagerDuty API 機能を LLM に公開し、インシデント、サービス、チーム、およびユーザーの管理を可能にするサーバー。

  1. 概要
    1. インストール
      1. PyPIから
      2. ソースから
    2. 要件
      1. 構成
        1. 使用法
          1. グースエクステンションとして
          2. スタンドアロンサーバーとして
        2. 応答フォーマット
          1. エラー処理
          2. パラメータ検証
          3. レート制限とページネーション
          4. 使用例
        3. ユーザーコンテキスト
          1. 発達
            1. テストの実行
            2. MCP Inspector を使用したデバッグサーバー
          2. 貢献
            1. リリース
            2. ドキュメント
            3. コンベンション

          Related Resources

          Related MCP Servers

          • Logseq MCP Server

            dailydaniel
            A
            security
            A
            license
            A
            quality
            A server that enables LLMs to programmatically interact with Logseq knowledge graphs, allowing creation and management of pages and blocks.
            Last updated -
            10
            17
            Python
            MIT License

          • Backlog MCP Server

            fleagne
            A
            security
            A
            license
            A
            quality
            An MCP server implementation that integrates with Backlog API, enabling project management operations including issues, projects, and wikis through natural language interactions.
            Last updated -
            12
            53
            3
            TypeScript
            MIT License

          • Lark MCP Server

            lorrylockie
            -
            security
            F
            license
            -
            quality
            A server that enables LLMs to interact with Lark/Feishu services, currently supporting employee information queries via Lark's Contact API.
            Last updated -
            3
            JavaScript

          • Sequential Questioning MCP Server

            bitgeese
            -
            security
            F
            license
            -
            quality
            A specialized server that enables LLMs to gather specific information through sequential questioning, implementing the MCP standard for seamless integration with LLM clients.
            Last updated -
            Python

          View all related MCP servers

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/wpfleger96/pagerduty-mcp-server'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server