跳至主要內容

操作使用

BladeX大约 6 分钟mcptool

操作说明

本文档详细介绍MCP工具箱模块的具体操作步骤，包括工具的新增、编辑、调试、状态管理等核心功能。请按照步骤进行操作，确保配置的准确性和有效性。

一、MCP工具箱总览

  1. 登录AI平台，选择【大模型工具】>【MCP工具箱】，进入MCP工具箱管理页面。
  2. 在页面顶部可以看到不同类型的工具标签：地图工具、聊天工具、浏览器工具、文件工具。
  3. 点击对应标签可以查看该类型下已配置的所有MCP工具。
  4. 每个工具卡片显示工具名称、协议类型、默认标识、锁定状态等关键信息。
MCP工具箱主页
MCP工具箱主页

二、新增MCP工具（SSE模式）

  1. 在MCP工具箱页面，点击【添加MCP工具】按钮，打开新增工具配置表单。
  2. 填写工具基础信息：
    • 协议名称：输入工具的唯一标识名称
    • 协议描述：输入工具功能的详细说明
    • 协议类型：选择"SSE"模式
  3. 配置SSE连接参数：
    • SSE地址：填入完整的SSE服务地址（包含API密钥）
SSE模式新增
SSE模式新增
  1. 点击【解析】按钮验证配置并获取工具列表。
  2. 系统会在下方显示解析出的工具列表，包含工具名称和描述。
  3. 确认配置无误后点击【确定】保存工具配置。

注意事项

  • SSE地址必须是完整有效的URL，包含协议头（http://或https://）
  • 确保服务端点支持MCP协议标准
  • 建议在解析前测试服务可用性

三、新增MCP工具（STDIO模式）

  1. 在MCP工具箱页面，点击【添加MCP工具】按钮，打开新增工具配置表单。
  2. 填写工具基础信息：
    • 协议名称：输入工具的唯一标识名称
    • 协议描述：输入工具功能的详细说明
    • 协议类型：选择"STDIO"模式
  3. 配置STDIO连接参数：
    • 命令行：输入启动工具的完整命令（支持多行命令或逗号分隔）
    • 环境变量：采用JSON格式配置环境变量，格式为{"变量名": "变量值"}
STDIO模式新增
STDIO模式新增
  1. 点击【解析】按钮测试命令可执行性并获取工具列表。
  2. 系统会在下方显示解析出的工具列表。
  3. 确认配置无误后点击【确定】保存工具配置。

配置要点

  • 确保命令行程序已正确安装在系统中
  • 环境变量配置需要严格遵循JSON格式
  • 建议先在本地测试命令的可执行性

四、编辑MCP工具配置

  1. 在MCP工具列表中，将鼠标悬停在要编辑的工具卡片上。
  2. 点击出现的【编辑】按钮（铅笔图标），打开编辑表单。
  3. 修改需要更新的配置参数，包括名称、描述、连接参数等。
  4. 如果修改了关键配置（如SSE地址或命令行），建议重新点击【解析】按钮验证。
工具编辑界面
工具编辑界面
  1. 确认修改后点击【确定】保存更新。

编辑限制说明

  • 已锁定的工具无法编辑（需先解锁）
  • 默认工具建议谨慎修改，避免影响系统功能
  • 修改关键配置后务必重新验证工具可用性

五、MCP工具调试功能

  1. 在MCP工具列表中，点击要调试的工具卡片上的【调试】按钮（位置图标）。
  2. 系统打开调试弹窗，左侧面板显示该工具下的所有可用工具列表。
  3. 在右侧调试区域配置测试参数：
    • 选择测试使用的AI模型
    • 输入测试提示词
工具调试界面
工具调试界面
  1. 点击【调试】按钮开始执行测试。
  2. 右侧面板会实时显示工具执行结果和输出信息。
  3. 可以点击【复制】按钮复制调试结果。
调试操作演示
调试操作演示

六、设置默认工具

  1. 在MCP工具列表中，将鼠标悬停在要设置为默认的工具卡片上。
  2. 点击出现的【星形】图标，系统会弹出确认对话框。
  3. 点击【确定】确认设置该工具为当前类型的默认工具。
设置默认工具
设置默认工具
  1. 设置成功后，该工具卡片会显示【默认】标签，表示已成为该类型的默认工具。
  2. 其他模块在选择工具时，会优先显示和选择默认工具。

七、工具锁定管理

  1. 在MCP工具列表中，将鼠标悬停在要锁定的工具卡片上。
  2. 点击出现的【锁定】图标（开锁图标表示锁定，锁定图标表示解锁）。
  3. 系统会弹出确认对话框，点击【确定】完成锁定或解锁操作。
工具锁定管理
工具锁定管理
  1. 锁定成功后，工具卡片会显示【已锁定】标签。

锁定功能说明

  • 锁定状态下的工具无法编辑、删除或修改配置
  • 需要相应权限才能解锁工具
  • 锁定功能可防止重要工具被误操作影响系统功能

八、删除MCP工具

  1. 在MCP工具列表中，将鼠标悬停在要删除的工具卡片上。
  2. 点击出现的【删除】按钮（垃圾桶图标）。
  3. 系统会弹出确认对话框，点击【确定】完成删除。

删除提示

  • 已锁定的工具无法删除
  • 正在使用中的工具建议先停用再删除
  • 删除操作不可恢复，请谨慎操作

九、工具类型切换和筛选

  1. 标签页切换：点击页面顶部的标签页（地图工具、聊天工具、浏览器工具、文件工具）可快速切换工具类型。
  2. 搜索筛选：在搜索框中输入工具名称，可快速查找特定的MCP工具。
  3. 分页浏览：使用页面底部的分页组件浏览大量工具配置。

十、MCP工具配置最佳实践

1. 命名规范

  • 使用清晰、有意义的工具名称
  • 建议包含工具类型和功能描述
  • 例如：地图-高德API、浏览器-网页抓取工具

2. 分类管理

  • 合理选择工具类型，便于管理和查找
  • 建议按功能用途进行分类
  • 保持分类体系的一致性

3. 安全配置

  • 定期更新API密钥和连接参数
  • 对重要工具设置锁定保护
  • 定期检查工具的可用性和安全性

4. 性能优化

  • 为不同场景选择合适的协议类型
  • 合理设置默认工具，提高使用效率
  • 定期清理不使用的工具配置
上次编辑于:
贡献者: smallchill