Rootly MCP Server

🚀 Rootly MCP 服务器

Rootly MCP 服务器是专门为 Rootly API 创建的 MCP 服务器。它可以集成到 Cursor、Windsurf 和 Claude 等兼容的 MCP 编辑器中，让您无需离开 IDE，就能在不到一分钟的时间内解决生产故障。

🚀 快速开始

🔍 先决条件

• Python 3.12 或更高版本
• uv 包管理器，可使用以下命令安装：

curl -LsSf https://astral.sh/uv/install.sh | sh

• [Rootly API 令牌](https://docs.rootly.com/api-reference/overview#如何生成一个 API 密钥%3F)

💻 在 IDE 中运行

您可以通过我们的 PyPi 包 或克隆此仓库进行安装。

要在您喜欢的 MCP 兼容编辑器（我们已测试过 Cursor 和 Windsurf）中设置，请使用以下配置：

{
"mcpServers": {
"rootly": {
"command": "uvx",
"args": [
"--from",
"rootly-mcp-server",
"rootly-mcp-server"
],
"env": {
"ROOTLY_API_TOKEN": ""
}
}
}
}

如果您想自定义 allowed_paths 以访问更多 Rootly API 路径，请克隆此包并使用以下配置：

{
"mcpServers": {
"rootly": {
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/rootly-mcp-server",
"rootly-mcp-server"
],
"env": {
"ROOTLY_API_TOKEN": ""
}
}
}
}

✨ 主要特性

此服务器根据 Rootly 的 OpenAPI（Swagger）规范动态生成 MCP 资源：

• 根据 Rootly 的 OpenAPI 规范动态生成 MCP 工具
• 默认分页（每页 10 个项目）以防止上下文窗口溢出
• 限制暴露给 AI 代理的 API 路径数量

我们限制了可访问的路径数量，原因有两个：

• 上下文大小：因为 Rootly 的 API 非常丰富，AI 代理可能会不知所措，无法正确执行简单操作。目前我们只暴露 /incidents 和 /incidents/{incident_id}/alerts。
• 安全：如果您希望限制用户通过 MCP 服务器访问的信息或操作类型

如果您想使更多路径可用，请编辑 src/rootly_mcp_server/server.py 中的 allowed_paths 变量。

⚠️ 免责声明

该项目是一个原型，不适合生产使用。如果您有任何功能建议或发现问题，请随时提交 PR 或打开问题。

👨‍💻 关于 Rootly AI 实验室

此项目由 Rootly AI Labs 开发。Rootly AI Labs 正在构建系统可靠性和运营卓越性的未来。我们作为开源孵化器运作，分享想法、进行实验并快速原型化。我们致力于确保我们的研究惠及整个社区。