MCP PagerDuty

MCP PagerDuty

🚧 早期开发阶段 - 正在开发中 🚧

一个模型上下文协议（MCP）服务，可集成 PagerDuty，用于事件管理和监控操作。

⚠️ 项目状态

本项目目前处于初始开发阶段。许多功能仍在规划中，尚未实现。欢迎贡献和反馈！

🚀 入门指南

前提条件

• Python 3.13 或更高版本
• PagerDuty API 令牌

安装

1. 克隆仓库

   git clone https://github.com/judexzhu/mcp-pagerduty.git
   cd mcp-pagerduty
   

2. 使用 UV 安装依赖项

   uv sync
   

3. 配置环境

   cp .env.example .env
   # Edit .env with your PagerDuty API credentials
   

配置

创建一个 .env 文件，填写 PagerDuty 配置：

PAGERDUTY_API_TOKEN=your_api_token_here
PAGERDUTY_API_URL=https://api.pagerduty.com

注意：如果未指定，PAGERDUTY_API_URL 为可选项，默认值为 https://api.pagerduty.com。

🔧 开发

本项目正在积极开发中。当前结构如下：

mcp-pagerduty/
├── pagerduty.py          # Main MCP server implementation
├── pyproject.toml        # Project configuration
├── .env                  # Environment variables (create from .env.example)
└── README.md            # This file

运行服务

python pagerduty.py

📚 MCP 集成

本服务实现了模型上下文协议，为 AI 助手和其他 MCP 客户端提供 PagerDuty 功能。

当前工具

• pagerduty_list_incidents - 根据筛选条件列出事件
• pagerduty_get_incident - 获取事件详细信息
• pagerduty_get_incident_notes - 获取事件详细信息

计划中的资源

• 事件模板
• 升级策略信息
• 服务状态仪表板

🤝 贡献

本项目仍处于早期开发阶段，非常欢迎大家贡献！

如何贡献

1. 复刻仓库
2. 创建功能分支

   git checkout -b feature/your-feature-name
   

3. 进行更改
4. 添加测试（测试框架搭建完成后）
5. 提交拉取请求

开发优先级

当前开发优先级：

1. 🔴 高优先级：基本的事件列表和检索功能
2. 🟡 中优先级：事件创建和更新
3. 🟢 低优先级：升级管理等高级功能

📋 待办事项

• 实现基本的 MCP 服务结构
• 添加 PagerDuty API 客户端
• 实现事件管理工具
• 添加全面的错误处理
• 编写测试
• 添加日志记录和监控
• 创建示例配置
• 编写完整的文档

🐛 已知问题

• 项目处于初始开发阶段
• 尚未实现任何功能
• 尚未构建 API 集成

📖 资源

• PagerDuty API 文档
• 模型上下文协议规范
• MCP Python SDK

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

🆘 支持

由于本项目处于早期开发阶段：

• 📝 文档：即将推出
• 🐛 错误报告：请提交问题
• 💡 功能请求：欢迎通过问题提交
• 💬 疑问：请发起讨论或提交问题

---

注意：本项目与 PagerDuty, Inc. 无关联。这是一个由社区驱动的模型上下文协议集成项目。