Devhelm Mcp Server

本地服务

docs.devhelm.io开发工具15 天前更新

代码仓库访问官网

关于 Devhelm Mcp Server

Devhelm MCP Server 将 DevHelm 的监控、事件和告警管理能力提供给 AI 编码助手。它覆盖监控配置、运行结果、依赖状态及状态页，也通过确认步骤保护删除、发布和回滚等操作。

主要功能

01创建、配置和控制运行监控
02管理监控代码检查与版本
03查看运行步骤、日志和产物
04处理事件与告警策略
05管理依赖、状态页及测试收件箱

适用场景

01检查服务监控和运行历史
02调查并更新线上事件
03调整告警渠道与通知策略
04测试邮件和 Webhook 接收流程

MCP 相关

这是一个 MCP 服务，通过托管端点或本地 stdio 向兼容客户端暴露 DevHelm 的监控、事件、告警及相关管理工具。

#monitoring #observability #uptime #infra #mcp

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "devhelmhq": {
      "command": "uvx",
      "args": [
        "devhelm-mcp-server"
      ],
      "env": {
        "DEVHELM_API_TOKEN": "<DEVHELM_API_TOKEN>"
      }
    }
  }
}

启动命令uvx devhelm-mcp-server

需要配置的环境变量

DEVHELM_API_TOKEN密钥DevHelm API token for authentication

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypidevhelm-mcp-server1.0.2stdio

工具

121

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

DevHelm MCP 服务

模型上下文协议（MCP）服务，适用于 DevHelm — 让 AI 编码助手（Cursor、Claude Desktop、Windsurf 等）能够访问你的运行时间监控器、事件、告警等。

快速开始

托管服务（推荐）

使用托管服务 mcp.devhelm.io。支持两种连接模式：

Bearer 身份验证：

URL: https://mcp.devhelm.io/mcp
Authorization: Bearer <your-api-token>

URL 中的 API 密钥（适用于只接受 URL 的客户端）：

URL: https://mcp.devhelm.io/<your-api-token>/mcp

本地（stdio）

pip install devhelm-mcp-server
export DEVHELM_API_TOKEN=your-token
devhelm-mcp-server

也可以使用 uvx（无需安装）：

export DEVHELM_API_TOKEN=your-token
uvx devhelm-mcp-server

Cursor / Claude Desktop

添加到你的 MCP 配置中：

{
  "mcpServers": {
    "devhelm": {
      "url": "https://mcp.devhelm.io/<your-api-token>/mcp"
    }
  }
}

可用工具

类别	工具
监控器	list、get、create、update（BROWSER / MULTI_STEP_API 的内联 `code`）、delete（需确认）、restore、trash、pause、resume、mute、unmute、quarantine、release quarantine、drift、versions、history（`list_monitor_results` 是弃用的别名，有效期至 2027-01-31）
代码检查	test、probe、test ad hoc、run now、trigger；修订版本 list、get、files、create draft、test、diff、discard；publish 和 rollback（需确认）、rollback preview
运行记录	get（运行记录封装，`wait_s` ≤ 25）、list、steps、console、network、artifacts（截图作为图像、trace/HAR 作为签名 URL）、trace summary、diff、cancel
账户	runtimes list/get、usage、entitlements
事件	list、get、create、update、acknowledge、add update、resolve、runs、events、related、trigger；提示词 `investigate_incident`
告警渠道	list、get、create、update、delete、test
通知策略	list、get、create、update、delete、test
环境	list、get、create、update、delete
密钥	list、set value、create、update（通过 elicitation 或控制面板链接设置值，绝不会在聊天中提供）、delete
标签	list、get、create、update、delete
资源组	list、get、create、update、delete、add member、remove member
Webhook	list、get、create、update、delete、test
API 密钥	list、create、revoke、delete
依赖项	list、get、track、delete
部署锁	acquire、current、release、force-release
状态	overview
状态页	pages、components、groups、incidents、maintenance、subscribers、domains
邮件测试	create address、wait（≤25 s）、latest、list/get messages、source、OTP codes、links、inject；domains list、get、create、update、verify、activity
Webhook 测试	inboxes list、get、create、update、activity；wait（≤25 s）、latest、list/get events

delete、publish 和 rollback 会先返回 {status: "confirmation_required", changes, confirmationToken}；用户同意后，使用 confirmation_token 再次调用。令牌由服务进程使用 HMAC 签名（设置 DEVHELM_MCP_CONFIRMATION_SECRET，让每个副本共用密钥），有效期为 15 分钟。错误会以 isError 返回，包含所有 ErrorResponse 字段以及供 Agent 使用的说明句。

开发

uv sync
make dev          # Start with MCP Inspector (stdio)
make serve        # Start HTTP server on :8000
make test         # Run unit tests
make lint         # Check formatting
make typecheck    # Run mypy