WisdomSSH接入MCP服务：扩展AI运维助手能力的完整指南

一、什么是MCP服务？

MCP（Model Context Protocol，模型上下文协议）是一种用于AI助手与外部工具交互的协议。WisdomSSH内置了MCP服务支持，通过接入MCP服务，你可以扩展AI运维助手的能力，使其能够调用各种外部工具和服务。

二、WisdomSSH的MCP服务功能

WisdomSSH的MCP服务接入提供以下核心能力：

多方式接入与智能管理

灵活接入：支持HTTP连接、命令行启动等多种接入方式，兼容JSON配置、URL、命令等输入格式
智能解析：自动识别并解析不同格式的MCP服务器配置
统一管理：集中管理所有MCP服务器，实时监控连接状态

AI集成与安全保障

AI能力扩展：AI助手可直接调用MCP服务工具，支持自然语言交互和上下文感知
安全控制：通过API Key、自定义Headers进行身份验证，敏感数据本地处理，保障隐私安全

三、MCP服务的接入方式

WisdomSSH支持多种MCP服务接入方式，系统会智能解析您的输入并自动选择合适的连接方式：

3.1 接入步骤

打开WisdomSSH应用
在左侧导航栏中点击MCP服务图标
点击添加MCP服务器按钮
在弹出的对话框中，输入以下任一格式的MCP服务器信息：
- JSON配置
- URL
- 命令
系统会自动识别并解析输入内容
确认服务器配置信息（如服务器名称、类型、URL/命令等）
点击保存按钮完成添加

3.2 支持的输入格式

JSON配置

直接输入MCP服务器的完整JSON配置，格式如下：

{
  "mcpServers": {
    "服务名称": {
      "url": "MCP服务器地址",
      "headers": {
        "Authorization": "认证信息"
      }
    }
  }
}

URL

直接输入MCP服务器的HTTP/HTTPS URL地址：

https://mcp.example.com

命令

输入启动MCP服务的命令（支持uvx、npx、python、node、npm、yarn、pnpm等命令前缀）：

npx -y @modelcontextprotocol/mcp-server@latest

或本地Python脚本：

python -m mcp_server --port 8000

3.4 配置说明

根据不同的连接类型，配置项有所不同：

HTTP类型配置

name: 服务器名称
type: "http"
url: MCP服务器地址
headers: 自定义HTTP头部信息（可选）

命令类型配置

name: 服务器名称
type: "command"
command: 命令名称
args: 命令参数（可选）
env: 环境变量（可选）

四、启用MCP服务

启用MCP服务需要两个步骤，确保服务器连接和AI工具使用都处于启用状态：

启用步骤

启用服务器连接：在MCP服务列表中，找到需要启用的服务器，点击开关按钮将其设置为启用状态，等待连接状态变为已连接
- 如果连接失败，系统会自动回滚到禁用状态并显示错误信息
- 连接成功后，点击已连接的MCP服务器即可展开显示可用的工具列表
启用AI工具：在AI助手的功能开关中，找到MCP工具选项，点击开关按钮将其切换到开启状态
- 系统会自动获取已启用MCP服务器提供的工具列表
- 启用后，即可在AI对话中使用MCP工具

启用条件

服务器连接开关：控制是否连接到特定的MCP服务器
AI工具开关：控制是否在AI对话中使用MCP服务提供的工具

只有当两个开关都开启时，才能在AI助手的对话中使用MCP服务提供的工具。

五、示例：接入Gitee MCP服务器

以下是接入Gitee MCP服务器的简单示例：

获取Gitee个人访问令牌

登录Gitee账号
进入设置 > 安全设置 > 私人令牌
点击生成新令牌
选择需要的权限
生成并保存令牌

添加Gitee MCP服务器

在添加MCP服务器时，使用以下JSON配置：

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer 你的Gitee个人访问令牌"
      }
    }
  }
}

解析并保存配置后，启用该服务器即可。

六、如何使用MCP服务？

接入并启用MCP服务后，你可以在WisdomSSH的AI运维助手中使用扩展功能。

基本使用方法

打开AI聊天窗口
使用自然语言描述你想要完成的任务
AI助手会自动调用MCP服务提供的工具完成任务

使用示例

以前面章节中接入的Gitee MCP服务器，展示如何通过自然语言使用MCP服务：

示例1：代码仓库管理

帮我列出所有代码仓库

示例2：Issue管理

帮我创建一个新的Issue，标题为"修复登录功能bug"，内容为"登录页面在输入错误密码时没有显示错误提示"

七、MCP服务管理

查看MCP服务器列表

在设置 > MCP服务页面中，你可以查看所有已添加的MCP服务器及其连接状态。

编辑MCP服务器配置

在MCP服务列表中，找到需要编辑的服务器
点击编辑按钮
修改以下配置信息：
- 服务器名称：MCP服务器的名称
- 连接方式：HTTP或命令行
- URL/命令：MCP服务器的地址或启动命令
- API Key：访问MCP服务器的API密钥
- 自定义Headers：自定义HTTP头部信息
- 环境变量：命令行方式下的环境变量
点击保存按钮

删除MCP服务器

在MCP服务列表中，找到需要删除的服务器
点击删除按钮
确认删除操作

启用/禁用MCP服务

MCP服务的启用/禁用分为两个层面：

服务器连接开关：在每个MCP服务器的条目上，可以单独启用或禁用该服务器的连接
AI助手功能开关：在AI助手的功能设置中，可以全局启用或禁用MCP工具的使用

只有当服务器连接开关和AI助手功能开关都开启时，才能在AI对话中使用MCP服务提供的工具。

八、常见问题

Q：为什么连接MCP服务器失败？

A：可能的原因有：

网络连接问题
MCP服务器地址或命令不正确
认证信息（API Key、Headers等）无效
环境变量配置错误
MCP服务器本身故障

请检查上述因素，并确保配置正确。

Q：如何获取更多MCP服务器？

A：你可以：

寻找支持MCP协议的第三方服务
使用开源的MCP服务器实现
自己开发符合MCP协议的服务器

Q：MCP服务会影响WisdomSSH的性能吗？

A：MCP服务在不使用时不会影响WisdomSSH的性能。只有当AI助手需要调用MCP工具时，才会与MCP服务器进行通信。

Q：可以同时连接多个MCP服务器吗？

A：是的，WisdomSSH支持同时连接多个MCP服务器，AI助手会自动选择合适的工具完成任务。

九、最佳实践

1. 选择合适的接入方式

对于稳定的远程服务，建议使用HTTP连接方式
对于需要本地处理的服务，建议使用命令行方式

2. 合理配置认证信息

根据MCP服务器的要求，配置适当的认证信息
妥善保管API Key等敏感信息

3. 定期检查连接状态

定期检查MCP服务器的连接状态
及时更新MCP服务器的配置信息

4. 充分利用AI助手

使用自然语言描述任务，让AI助手自动调用合适的工具
提供足够的上下文信息，以便AI助手更好地理解你的需求

十、总结

WisdomSSH的MCP服务为AI运维助手提供了强大的扩展能力，通过接入MCP服务，你可以让AI助手调用各种外部工具和服务，显著提升工作效率。WisdomSSH支持多种接入方式，提供了统一管理功能，让你可以轻松地集成和使用各类MCP服务。

通过简单的配置和启用步骤，你可以将丰富的MCP服务集成到WisdomSSH中，为各种运维场景提供强大的支持。通过自然语言交互，你可以轻松地使用MCP服务提供的功能，让AI助手成为你的得力助手。