Extensions
MCP 服务器管理
在扩展中心管理 MCP 服务器:启用、测试、删除,以及添加自定义 MCP
MCP 服务器管理
MCP(Model Context Protocol) 服务器以独立进程形式给 AI 引擎提供工具能力。WinCode 在扩展中心里集中展示所有 MCP 服务器,包括内置的网络搜索和用户添加的自定义服务器。
内置 MCP:网络搜索
WinCode 当前预装了一个网络搜索 MCP 服务器,让 AI 引擎能在对话中调用网络搜索工具,支持 Bing / Baidu / CSDN / 掘金等搜索引擎。
扩展中心 MCP 卡片
在扩展中心的"MCP 服务"列,每个 MCP 服务器显示为一张卡片:
- 标题:服务器名称
- 副标题:启动命令信息
- 环境变量标签:展示所有环境变量名称
- 状态标签:已启用(绿)/ 已停用(灰)
- 操作按钮:启用/停用、测试、删除
操作说明
| 按钮 | 行为 |
|---|---|
| 启用 / 停用 | 停用的服务器不会随应用启动 |
| 测试 | 启动服务器进程并尝试连接;成功显示绿色提示,失败弹出错误(例如命令不存在、端口占用) |
| 删除 | 移除该服务器配置;内置 MCP 不允许删除 |
测试后如果显示"需重载"状态,点击刷新或重启 WinCode 即可。
添加自定义 MCP
目前扩展中心 UI 暂未提供图形化的"添加 MCP"按钮。要添加自定义 MCP,可以通过以下步骤:
- 准备 MCP 服务器(可以是 npx 可执行或本地 Node 脚本)
- 在 WinCode 设置 → MCP 配置页面,新增一条 JSON 配置:
{
"mcpServers": {
"my-server": {
"command": "node",
"args": ["/absolute/path/to/server.js"],
"env": {
"API_KEY": "xxx"
}
}
}
}- 保存后回到扩展中心,新服务器会出现;点击"测试"验证
配置格式说明
MCP 配置遵循 MCP 官方规范,核心字段:
| 字段 | 说明 |
|---|---|
id | 唯一标识,一般用服务器名 |
enabled | 是否启用 |
command | 启动命令,如 "node" |
args | 命令参数 |
env | 环境变量 |
url | HTTP/SSE 远程端点地址 |
WinCode 支持两种启动方式:
- stdio:设置
command+args,启动子进程通过标准输入输出通信 - HTTP/SSE:设置
url,连接远程服务器
故障排除
| 现象 | 排查方向 |
|---|---|
| 测试失败,报"spawn ENOENT" | 启动命令找不到,检查 node 是否在 PATH,或使用绝对路径 |
| 测试通过但实际调用报错 | 检查环境变量是否齐全 |
| 状态显示"需重载" | 点击刷新,或重启 WinCode |
| 内置 MCP 消失 | 重新安装 WinCode |