VS Code客户端配置MCP

示例客户端版本: 1.143.1

1. 接入与验证

在支持 Streamable HTTP 的 MCP 客户端中，配置乐维监控服务地址：

https://<乐维监控域名>/lerwee/mcp/streamable

客户端按顺序完成 initialize、notifications/initialized，然后通过 tools/list 获取工具清单。当前实现支持 2025-03-26 和 2025-06-18 两个协议版本；初始化请求可由客户端协商版本。

1，打开 VS Code 命令面板，运行 MCP: Add Server 2，选择传输类型： HTTP 3，填入上面的服务地址，并将服务名称设为 lerwee 4，根据使用范围选择个人或工作区配置 5，完成后在 MCP 服务列表中确认服务已启动且可以发现工具

在工作区 .vscode/mcp.json 写入配置：

{
  "servers": {
    "lerwee": {
      "type": "http",
      "url": "https://<乐维监控域名>/lerwee/mcp/streamable"
    }
  }
}

这里的 servers 是 .vscode/mcp.json 使用的字段；工作区根目录 .mcp.json 使用的是另一种格式，不要混用。配置字段以 VS Code MCP 配置说明为准。

当前乐维服务端本身未实现 Bearer Token 校验；如果生产网关开启认证，需要按网关要求配置请求头。

1，配置完成后，可在 VS Code Agent 聊天框做验证：

"使用 lerwee MCP 查询最近一天的严重告警，并说明调用了哪个工具"

✅校验要点：展开聊天的工具调用记录，确认来源为lerwee、工具为query_problems并且存在返回内容。仅看到 AI 文字回答，不能证明工具真正连通。

如果初始化失败：检查域名网络、接口地址是否为/lerwee/mcp/streamable、网关鉴权与来源限制；查看 VS Code 的 MCP 服务输出日志。服务端会校验 Origin 主机名，不支持的协议版本会直接返回错误

2，想直接验证工具调用，可以向同一地址发送如下 JSON-RPC 报文：

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "query_problems",
    "arguments": { "day": 1 }
  }
}

它表示查询最近一天未恢复、未确认的严重告警。返回结果位于 JSON-RPC 的 result.content 中，具体内容取决于监控系统的实时数据。如果客户端能发现工具并完成这次调用，便说明从客户端到乐维监控的基础查询链路已接通。

打开命令面板：View>Command Palette…，快捷键：Ctrl+Shift+P

📝成功日志标识：

Connection state: Running 和 Discovered 9 tools

出现以上两行代表连接成功；卡住或报错一般为网络、鉴权问题。

想了解的问题	对应工具
近期有哪些严重告警？指定主机有哪些严重告警？	query_problems、query_host_problems
近期告警如何分布？某类告警或整体告警的历史趋势如何？	report_problem、query_problem_histories、query_problem_trends
当前系统资源监控情况如何？	report_monitor
某用户管理哪些主机？主机关联哪些资产？负责人是谁？	query_user_hosts、query_host_cmdb、query_host_user

“查看最近一天的严重告警。”

“其中 db-01 这台主机还有哪些严重告警？”

“查询 db-01 关联的资产及负责人。”

“把近七天的告警趋势展示出来。”

这一流程把告警巡检、资产定位与责任人查询串了起来，减少在多个页面之间反复切换。若用户提出“确认告警”“关闭问题”或“创建维护窗口”，当前这组 MCP 工具没有对应的写入能力，不应将其描述为已经支持自动处置。