← 返回目录

PagerDuty MCP Server

官方

已归档

PagerDuty 官方 MCP 服务器，直接从 IDE 或聊天客户端管理事件与值班

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 60 / 438
Stars: ★ 79 热门
传输方式: stdio（本地进程） · Streamable HTTP · SSE
运行环境: Python · Docker
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 37 天前
工具数: 82

64FMRS · C

PagerDuty 官方维护的 MCP 服务器，工具覆盖事件、服务、排班、升级策略、编排、团队、状态页和 webhook 等 PagerDuty 核心资源，默认只读、写入需显式开启。功能全面但写入权限与账户级 API Key 权限较大，且 HTTP 传输缺乏内置认证，需谨慎部署。

最强项 · 文档质量 17/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

14/20

维护活跃度

11/20

文档质量

17/20

安装易用性

14/20

查看各项评分依据

可靠性 8/20: manifest 声明了 stdio 传输、uvx 运行方式及完整的工具清单（读/写标注清晰），README 中的工具表与 manifest 描述基本一致，没有明显自相矛盾之处。但仓库材料中未提供任何 CI 工作流文件或测试代码证据，无法验证 MCP 初始化握手、工具列表返回、错误处理等关键路径是否真实可复现，属纯静态审查且缺少可执行证据，因此依据校准规则不能给出高于 12 的分数。可靠性主要靠文档中的表格自证，未见错误处理/依赖故障降级的具体说明，扣分较多。
安全与权限 14/20: 该服务器对风险披露较为透明：默认仅暴露只读工具，写操作需要显式的 --enable-write-tools 标志才能开启；README 明确警告 HTTP 传输（streamable-http/sse）没有内置鉴权，默认绑定 127.0.0.1，并提示只有在有反向代理/网关鉴权时才应绑定 0.0.0.0；同时提醒 Claude Desktop 配置文件以明文存储 API Key 的风险。未发现硬编码密钥、真实令牌示例或红线级别问题。扣分点：使用的是用户级完整权限的 PagerDuty User API Token，没有最小权限范围控制；对 delete_team、delete_webhook_subscription、manage_incidents 等不可逆或高影响操作，除全局的写开关外没有单独的二次确认机制；嵌入式 React UI（Incident Command Center 等）引入了额外攻击面，但文档未详细说明其数据流和沙箱边界。
维护活跃度 11/20: 仓库为 Apache-2.0 许可，非归档状态，manifest 版本为 0.2.1，表明项目仍处于早期到中期迭代阶段。给定材料中没有提交历史、发布记录或依赖更新频率的直接证据；35 个未解决 issue 相对 75 星的关注度而言比例不低，但无法判断响应速度或维护者活跃程度。作为官方厂商（PagerDuty）项目，治理归属明确，这是加分项，但缺少版本发布节奏、安全响应渠道等佐证信息，导致无法评为更高分。
文档质量 17/20: README 内容层次丰富：涵盖前置条件、多种客户端集成（Cursor、VS Code、Claude Desktop）、Docker 部署、三种传输模式对比表、环境变量配置表，以及按功能分类且标注只读/写属性的完整工具清单，并专门用一节讨论 HTTP 传输的安全边界。这些都构成可核查证据。不足之处：未提供具体工具调用参数示例或返回数据样例，未说明 PagerDuty API 速率限制、调用配额或潜在费用影响，故障排查部分也仅限于'重启客户端'等基础建议，深度不够。
安装易用性 14/20: 安装路径较为清晰：通过 uvx/pip 安装、设置一个必需环境变量（PAGERDUTY_USER_API_KEY）即可运行，并为 Cursor、VS Code、Claude Desktop、Docker 分别给出了具体配置示例，步骤数量少、跨平台覆盖全。但按静态校准要求，由于没有 CI 或测试文件证明这些配置真实可用、可复现，安装易用性分数被限制在 15 分以下；此外多客户端配置中命令行参数（如 --enable-write-tools 注释放在 JSON 内）可能需要用户自行调整，存在一定手动风险。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已经使用 PagerDuty 的 SRE / 值班工程师
希望在 IDE 中进行 AI 辅助事件分诊的 DevOps 团队
需要通过对话方式查询事件指标或管理排班的团队

不适合谁

未使用 PagerDuty 的团队
需要严格最小权限、按角色细分令牌权限的组织（该服务器使用用户级 API Token，权限等同于该用户）
希望在不受信任网络上直接暴露 HTTP 端点、且没有认证反向代理的部署场景

所需权限

需要一个 PagerDuty User API Token（`PAGERDUTY_USER_API_KEY`），拥有该用户在 PagerDuty 账户中的完整权限
默认仅暴露只读工具；需显式传入 `--enable-write-tools` 才能创建、更新或删除事件、服务、团队、排班、升级策略、webhook 和状态页内容
可选设置 `PAGERDUTY_API_HOST` 以指向标准或欧盟区域的 API 端点

风险与副作用

streamable-http 和 sse 传输没有内置身份验证，任何能访问该主机端口的客户端都可以使用启动服务器时所用的那个 API Key 调用工具（包括写入工具）；README 明确警告仅在本地回环地址使用，或将 0.0.0.0 部署放在具备身份验证的反向代理/网关之后
写入工具权限较大，可创建/删除团队、修改升级策略与排班、创建状态页事件帖子等，误操作可能影响真实的值班和客户可见的状态页
创建 webhook 订阅会返回签名密钥，需妥善保存避免泄露
Claude Desktop 的配置文件要求以明文形式存储 API Key，需注意文件权限

安装接入

准备工作

运行环境：Python · Docker

PAGERDUTY_USER_API_KEY 必填密钥必填的 PagerDuty User API Token，在 PagerDuty 账户的 User Settings > API Access 中生成。

其他可选配置项（3 个）

PAGERDUTY_API_HOST 可选可选的 API 地址，默认 https://api.pagerduty.com，EU 账户使用 https://api.eu.pagerduty.com。

MCP_HOST 可选可选，HTTP 传输模式下的监听地址，默认 127.0.0.1。

MCP_PORT 可选可选，HTTP 传输模式下的监听端口，默认 8000，必须为整数。

在 PagerDuty「用户设置 > API Access」中生成一个 User API Token。
确保系统已全局安装 uv/uvx（或改用本地源码 uv run / Docker 镜像）。
在 Cursor、VS Code 或 Claude Desktop 的 MCP 配置中添加 pagerduty-mcp 服务器，命令为 uvx pagerduty-mcp，如需写入能力追加 --enable-write-tools 参数。
通过环境变量设置 PAGERDUTY_USER_API_KEY（必填）和可选的 PAGERDUTY_API_HOST（欧盟账户需设为 https://api.eu.pagerduty.com）。
重启客户端，并通过提问（如“显示我最新的事件”）验证连接是否成功。

claude_desktop_config.json

{"mcpServers":{"pagerduty-mcp":{"command":"uvx","args":["pagerduty-mcp","--enable-write-tools"],"env":{"PAGERDUTY_USER_API_KEY":"your-pagerduty-api-key-here","PAGERDUTY_API_HOST":"https://api.pagerduty.com"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "pagerduty-mcp": {
      "command": "uvx",
      "args": [
        "pagerduty-mcp",
        "--enable-write-tools"
      ],
      "env": {
        "PAGERDUTY_USER_API_KEY": "your-pagerduty-api-key-here",
        "PAGERDUTY_API_HOST": "https://api.pagerduty.com"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add pagerduty-mcp -e PAGERDUTY_USER_API_KEY=your-pagerduty-api-key-here -e PAGERDUTY_API_HOST=https://api.pagerduty.com -- uvx pagerduty-mcp --enable-write-tools

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应出现 list_incidents 等工具；发送“Show me the latest incident”这类请求并收到 PagerDuty 数据即证明连接成功。

常见排障

确认已全局安装 `uv`/`uvx`，并且客户端命令能够找到它（必要时重启终端或 IDE）
确认 `PAGERDUTY_USER_API_KEY` 已正确设置；如为欧盟账户，需将 `PAGERDUTY_API_HOST` 设为 `https://api.eu.pagerduty.com`
若写入操作（如创建事件、排班覆盖）无效，检查启动参数中是否包含 `--enable-write-tools`
在 VS Code 中可通过命令面板搜索 `MCP: List Servers` 检查服务器运行状态，必要时重启
使用 HTTP 传输时确认 `MCP_HOST`/`MCP_PORT` 或 `--host`/`--port` 配置正确，且未在不受信任网络上直接暴露 0.0.0.0

试试这样问

连接成功后，可以直接对 AI 助手这样说：

显示我最近的事件
列出我的事件编排
给我看值班经理界面
为事件添加一条备注

工具能力 82

create_alert_grouping_setting 写入

创建新的告警分组设置

delete_alert_grouping_setting 破坏性

删除一个告警分组设置

get_alert_grouping_setting 只读

获取指定的告警分组设置

list_alert_grouping_settings 只读

列出告警分组设置，支持筛选

update_alert_grouping_setting 写入

更新现有的告警分组设置

get_incident_metrics_all 只读

获取所有服务范围内的聚合事件指标

get_incident_metrics_by_service 只读

按服务分组获取事件指标

get_incident_metrics_by_team 只读

按团队分组获取事件指标

展开其余 74 个工具

get_responder_load_metrics 只读

获取响应人员的负载指标

get_responder_metrics 只读

获取响应人员的绩效指标

get_business_service_dependencies 只读

获取指定业务服务的依赖关系

get_technical_service_dependencies 只读

获取业务服务对应的技术服务依赖关系

list_business_services 只读

列出业务服务

get_change_event 只读

获取指定的变更事件

list_change_events 只读

列出变更事件，支持可选筛选

list_incident_change_events 只读

列出与指定事件相关的变更事件

list_service_change_events 只读

列出指定服务的变更事件

get_event_orchestration 只读

获取指定的事件编排

get_event_orchestration_global 只读

获取某事件编排的全局编排配置

get_event_orchestration_router 只读

获取某事件编排的路由配置

get_event_orchestration_service 只读

获取指定服务的事件编排配置

list_event_orchestrations 只读

列出事件编排，支持可选筛选

update_event_orchestration_router 写入

更新事件编排的路由配置

append_event_orchestration_router_rule 写入

向事件编排路由添加一条新的路由规则

create_escalation_policy 写入

创建新的升级策略

get_escalation_policy 只读

获取指定的升级策略

list_escalation_policies 只读

列出升级策略

update_escalation_policy 写入

更新现有的升级策略

add_note_to_incident 写入

为事件添加备注

add_responders 写入

为事件添加响应人员

create_incident 写入

创建新的事件

get_alert_from_incident 只读

获取事件中指定的告警

get_incident 只读

获取指定的事件

get_outlier_incident 只读

获取指定事件的异常事件信息

get_past_incidents 只读

获取与指定事件相关的历史事件

get_related_incidents 只读

获取与指定事件相关联的事件

list_alerts_from_incident 只读

分页列出指定事件的所有告警

list_incident_notes 只读

列出指定事件的所有备注

list_incidents 只读

列出事件

manage_incidents 写入

更新事件的状态、紧急程度、分配或升级级别

get_incident_workflow 只读

获取指定的事件工作流

list_incident_workflows 只读

列出事件工作流，支持可选筛选

start_incident_workflow 写入

为事件启动一个工作流实例

get_log_entry 只读

根据 ID 获取指定的日志条目

list_log_entries 只读

按时间筛选列出账户范围内的所有日志条目

add_team_member 写入

将用户添加到团队并指定角色

create_team 写入

创建新团队

delete_team 破坏性

删除团队

get_team 只读

获取指定的团队

list_team_members 只读

列出团队成员

list_teams 只读

列出团队

remove_team_member 写入

将用户从团队中移除

update_team 写入

更新现有团队

get_user_data 只读

获取当前用户的数据

list_users 只读

列出 PagerDuty 账户中的用户

list_oncalls 只读

列出值班排班信息

list_priorities 只读

列出账户中定义的优先级

create_schedule_override 写入

为排班创建一个临时覆盖

get_schedule 只读

获取指定的排班

list_schedule_users 只读

列出排班中的用户

list_schedules 只读

列出排班

create_schedule 写入

创建新的值班排班

update_schedule 写入

更新现有排班

create_service 写入

创建新服务

get_service 只读

获取指定的服务

list_services 只读

列出服务

update_service 写入

更新现有服务

create_status_page_post 写入

在状态页上创建新帖子（事件或维护通知）

create_status_page_post_update 写入

为现有状态页帖子添加新更新

get_status_page_post 只读

获取指定状态页帖子的详情

list_status_page_impacts 只读

列出状态页可用的影响级别

list_status_page_post_updates 只读

列出指定状态页帖子的所有更新

list_status_page_severities 只读

列出状态页可用的严重程度级别

list_status_page_statuses 只读

列出状态页可用的状态

list_status_pages 只读

列出所有状态页，支持可选筛选

create_webhook_subscription 写入

创建新的 webhook 订阅（返回签名密钥）

delete_webhook_subscription 破坏性

删除 webhook 订阅

get_webhook_subscription 只读

获取指定的 webhook 订阅

list_webhook_subscriptions 只读

列出 webhook 订阅，支持按类型筛选

update_webhook_subscription 写入

更新现有 webhook 订阅

get_extension_schema 只读

获取指定的扩展模式

list_extension_schemas 只读

列出可用的扩展模式（供应商）

使用场景

在 IDE 或聊天客户端中查看、确认和解决 PagerDuty 事件

查询和管理值班排班及临时覆盖

创建/更新升级策略、服务和团队

生成事件指标、响应人员负载和绩效报告

管理状态页帖子和更新

在 VS Code 中使用内置的事件指挥中心、值班管理器等交互式应用

支持客户端

Claude Desktop

Cursor

VS Code

依据项目文档列出，未经本站实测。

详细介绍

PagerDuty 官方维护的本地 MCP（Model Context Protocol）服务器，为已启用 MCP 的客户端提供工具，用于直接操作 PagerDuty 账户，包括查看和管理事件、服务、值班排班、升级策略、事件编排、状态页和 webhook 等。服务器默认仅暴露只读工具，需显式添加 --enable-write-tools 参数才能启用会修改账户数据的写入工具。它还内置了基于 React 的交互式应用（事件指挥中心、值班管理器、值班薪酬报告、服务依赖图、入门向导），可在 VS Code 中直接展示。支持 stdio、streamable-http 和 sse 三种传输方式，可通过 uvx、本地源码或 Docker 运行。