项目简介

OpsLevel MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的后端应用，旨在将大型语言模型 (LLM) 客户端（如 Claude Desktop, VS Code Copilot, Cursor, Windsurf 等）连接到您的 OpsLevel 账号。它允许 AI 通过结构化的方式查询和理解 OpsLevel 中的服务、团队、基础设施等信息。

主要功能点

该服务器提供对 OpsLevel 账号数据的只读访问能力，允许 LLM 执行以下操作：

• 查询资源信息： 获取团队、用户、服务（组件）、基础设施、域、系统等列表及其详细信息。
• 访问文档： 检索与服务或整个账号相关的技术文档和 API 文档。
• 了解可用操作： 查看 OpsLevel 中可执行的预定义操作（例如，用于回滚或部署的服务触发器）。
• 检索过滤器信息： 获取用于评估服务质量的过滤器的详细信息。
• 根据用户查询获取相关 OpsLevel 数据： LLM 可以根据用户的自然语言问题（如“哪个团队拥有 backstage 服务？”、“如何回滚 OpsSight？”）调用相应的工具来获取必要的数据。

安装步骤

有几种方式可以安装 OpsLevel MCP 服务器：

1. 使用 Homebrew (macOS/Linux): 运行命令：'brew install opslevel/tap/opslevel-mcp'
2. 使用 Docker: 拉取 Docker 镜像：'docker pull public.ecr.aws/opslevel/mcp:latest' 您也可以指定版本，具体标签请查阅 ECR Gallery。
3. 手动安装: 访问项目的 GitHub Releases 页面，下载适用于您操作系统的二进制文件。

无论哪种安装方式，您都需要一个 OpsLevel API Token 来授权服务器访问您的 OpsLevel 账号。

服务器配置（供 MCP 客户端参考）

OpsLevel MCP 服务器被设计为一个可执行的二进制文件或 Docker 容器。当您在支持 MCP 的 LLM 客户端中配置它时，您需要提供以下关键信息：

• 服务器名称 (Server Name): 您给这个 MCP 服务器实例起的名字（例如，"opslevel"）。
• 启动命令 (Command): 客户端将用于启动服务器进程的命令。如果您手动安装了二进制文件，这通常是 'opslevel-mcp'。如果您使用 Docker，这通常是 'docker'。
• 启动参数 (Arguments): 如果使用 Docker 运行，您需要提供运行容器的参数，例如 'run', '-i', '--rm', '-e OPSLEVEL_API_TOKEN', 'public.ecr.aws/opslevel/mcp:latest'。这些参数告诉 Docker 如何以后台进程模式运行服务器，并传递必要的环境变量。
• 环境变量 (Environment Variables): 服务器必须接收 'OPSLEVEL_API_TOKEN' 环境变量，其中包含您的 OpsLevel API Token。客户端配置中通常会指定如何将这个 Token 安全地传递给服务器进程，例如通过配置字段或另一个环境变量。可选地，如果您的 OpsLevel 实例不是使用默认的 'https://app.opslevel.com' 地址（例如用于本地开发或私有部署），您还需要设置 'OPSLEVEL_APP_URL' 环境变量。

具体的配置格式取决于您使用的 LLM 客户端（如 Claude Desktop, VS Code, Cursor, Windsurf），但核心信息都是指定如何启动 'opslevel-mcp' 可执行文件或 Docker 容器，并传递 API Token。

基本使用方法

1. 安装 OpsLevel MCP 服务器： 按照上述步骤安装服务器二进制文件或 Docker 镜像。
2. 创建 OpsLevel API Token： 在您的 OpsLevel 账号中生成一个 API Token。
3. 配置 LLM 客户端： 在您的 LLM 客户端（如 Claude Desktop, VS Code Copilot Chat, Cursor, Windsurf 等）的设置中找到 MCP 服务器配置部分。添加一个新的 MCP 服务器配置，指定服务器名称、启动命令（通常是 'opslevel-mcp' 或 'docker run ... public.ecr.aws/opslevel/mcp:latest'）以及如何传递 'OPSLEVEL_API_TOKEN' 环境变量。
4. 与 LLM 交互： 配置完成后，您的 LLM 就可以利用 OpsLevel MCP 服务器提供的工具来访问 OpsLevel 数据。您可以在聊天窗口中直接询问关于 OpsLevel 资源的问题，例如：“请告诉我关于我的 services 的信息”，“如何联系 owning team？”等等。LLM 将通过 MCP 协议调用服务器提供的工具来获取答案。