> ## Documentation Index
> Fetch the complete documentation index at: https://doc.lwops.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# VS Code客户端配置MCP

示例客户端版本: 1.143.1

## **1. 接入与验证**

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

```text theme={null}
https://<乐维监控域名>/lerwee/mcp/streamable
```

客户端按顺序完成 initialize、notifications/initialized，然后通过 tools/list 获取工具清单。

当前实现支持 2025-03-26 和 2025-06-18 两个协议版本；初始化请求可由客户端协商版本。

## 2. **在 VS Code 中添加乐维 MCP(**二选一**)**

### 方式一：命令面板图形化配

1，打开 VS Code 命令面板，运行 MCP: Add Server

2，选择传输类型： **HTTP**

3，填入上面的服务地址，并将服务名称设为 lerwee

4，根据使用范围选择个人或工作区配置

5，完成后在 MCP 服务列表中确认服务已启动且可以发现工具

### 方式二：手动编辑配置文件

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

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

> [!TIP]
>
> 这里的 servers 是 .vscode/mcp.json 使用的字段；工作区根目录 .mcp.json 使用的是另一种格式，不要混用。配置字段以 [VS Code MCP 配置说明](https://code.visualstudio.com/docs/agents/reference/mcp-configuration)为准。

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

### 验证：

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

```text theme={null}
"使用 lerwee MCP 查询最近一天的严重告警，并说明调用了哪个工具"
```

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

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

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

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "query_problems",
    "arguments": { "day": 1 }
  }
}
```

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

## 3. 实战演示

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

* 输入框输入 MCP，选择 `MCP:Add Server...`

![Vscondetu1](https://mintcdn.com/lerwee/M8JuB1lNYv6bWrgC/images/vscondetu1.png?fit=max\&auto=format\&n=M8JuB1lNYv6bWrgC\&q=85\&s=90df7564797057a6c9a25a9056f7b241)

* 选择 `HTTP`

![Vccondetu2](https://mintcdn.com/lerwee/M8JuB1lNYv6bWrgC/images/vccondetu2.png?fit=max\&auto=format\&n=M8JuB1lNYv6bWrgC\&q=85\&s=90b3089d0d04c4e3ebc58468cdc36594)

* 填入乐维 MCP 服务地址

![Vscodetu3](https://mintcdn.com/lerwee/M8JuB1lNYv6bWrgC/images/vscodetu3.png?fit=max\&auto=format\&n=M8JuB1lNYv6bWrgC\&q=85\&s=a02cad78b5d6e52a4a4fcca6ba89ac74)

* 回车保存，生成 mcp.json 配置

![Vscodetu4](https://mintcdn.com/lerwee/M8JuB1lNYv6bWrgC/images/vscodetu4.png?fit=max\&auto=format\&n=M8JuB1lNYv6bWrgC\&q=85\&s=77080050ba65d1ff89abde2e4137f7fa)

* 点击 `Start` / `Running` 启动服务

![Vscodetu5](https://mintcdn.com/lerwee/M8JuB1lNYv6bWrgC/images/vscodetu5.png?fit=max\&auto=format\&n=M8JuB1lNYv6bWrgC\&q=85\&s=240fcd21391dc7b21b1a146d4fc6e434)

📝成功日志标识：

> `Connection state: Running`
>
> 和
>
> `Discovered 9 tools`

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

## 4.可以问哪些问题

| **想了解的问题** | **对应工具** |
| :- | :- |
| 近期有哪些严重告警？指定主机有哪些严重告警？ | query\_problems、query\_host\_problems |
| 近期告警如何分布？某类告警或整体告警的历史趋势如何？ | report\_problem、query\_problem\_histories、query\_problem\_trends |
| 当前系统资源监控情况如何？ | report\_monitor |
| 某用户管理哪些主机？主机关联哪些资产？负责人是谁？ | query\_user\_hosts、query\_host\_cmdb、query\_host\_user |

* 告警趋势工具默认返回文本统计，也支持通过 graph: true 返回图片。
* 工具名称和参数说明由 tools/list 提供，客户端可以据此选择调用方式。
* 一个典型的值班对话可以这样展开（以下为提问示意，不代表真实结果）：

```text theme={null}
“查看最近一天的严重告警。”

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

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

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.