使用说明

项目简介

Glutamate UI Assist MCP Server 是一个 Model Context Protocol (MCP) 服务器,旨在与 Glutamate 平台和 UI Assist 浏览器扩展协同工作。它扩展了 LLM 的能力,使其能够理解和操作网页用户界面 (UI) 元素。通过与浏览器扩展的连接,该服务器能够获取用户在浏览器中选取的 HTML 元素信息,并提供清除选中元素列表的功能。

主要功能点

  • 获取选中的 HTML 元素 (get_selected_elements): 允许 LLM 获取当前在浏览器中通过 UI Assist 扩展选中的 HTML 元素的详细信息,包括标签名、ID、类名、文本内容和属性。这使得 LLM 可以理解用户在网页上关注的具体内容。
  • 清除选中的 HTML 元素 (clear_selected_elements): 允许 LLM 清除当前选中的 HTML 元素列表。这可以用于重置选择状态或在多轮交互中管理上下文。
  • SSE 协议支持: 使用 Server-Sent Events (SSE) 协议与 MCP 客户端进行通信,实现实时的双向数据传输。
  • 浏览器连接器: 内置浏览器连接器,通过 WebSocket 与 UI Assist 浏览器扩展通信,接收和处理来自浏览器的 UI 元素信息。

安装步骤

  1. 安装 Glutamate 平台: Glutamate UI Assist MCP Server 是为 Glutamate 平台设计的。首先,访问 glutamateapp.com 下载并安装 Glutamate 桌面应用程序。
  2. 下载 GlutamateMCPServers 仓库: 从 GitHub 仓库 https://github.com/ShadowCloneLabs/GlutamateMCPServers 下载代码到本地。
  3. 在 Glutamate 平台中添加服务器: 打开 Glutamate 应用程序,按照 Glutamate 的指引添加新的 MCP 服务器。在配置服务器时,你需要提供服务器的启动命令和参数。

服务器配置

在 MCP 客户端(例如 LLM 应用或开发工具)中配置连接 Glutamate UI Assist MCP Server 时,你需要提供以下配置信息。这些信息通常以 JSON 格式配置在 MCP 客户端中:

{
  "serverName": "UI Assist MCP Server",
  "command": "path/to/your/node/executable/node",
  "args": [
    "path/to/GlutamateMCPServers/src/uiassist/index.js",
    "--port", "3332",
    "--connector-port", "3025"
  ]
}

配置参数说明:

  • 'serverName': 服务器名称,可以自定义,用于在 MCP 客户端中标识该服务器。例如 "UI Assist MCP Server"。
  • 'command': 启动服务器的命令。这里需要指定 Node.js 运行时可执行文件的路径。请将 '"path/to/your/node/executable/node"' 替换为你本地 Node.js 可执行文件的实际路径。 例如,在 macOS 或 Linux 系统中,通常为 '/usr/bin/node' 或 '/usr/local/bin/node';在 Windows 系统中,可能类似于 'C:\Program Files\nodejs\node.exe'。请确保 MCP 客户端运行的环境可以访问到 Node.js 环境。
  • 'args': 启动服务器的参数列表,是一个字符串数组。
    • '"path/to/GlutamateMCPServers/src/uiassist/index.js"': 请将 '"path/to/GlutamateMCPServers/src/uiassist/index.js"' 替换为 'index.js' 文件的实际路径。 你需要将 'GlutamateMCPServers' 仓库下载到本地,并找到 'src/uiassist/index.js' 文件的位置。提供该文件的绝对路径。
    • '"--port", "3332"': 可选参数,用于指定 MCP 服务器监听的端口。默认为 '3332'。如果需要修改端口,请修改此参数值。确保 MCP 客户端连接到相同的端口。
    • '"--connector-port", "3025"': 可选参数,用于指定浏览器连接器监听的端口。默认为 '3025'。 通常情况下不需要修改此端口,除非端口冲突。

重要提示: 'command' 和 'args' 中的路径需要根据你的实际环境进行调整。特别是 'index.js' 文件的路径,必须是 MCP 客户端能够访问到的文件系统路径。

基本使用方法

  1. 启动服务器: 在 Glutamate 平台中启动配置好的 UI Assist MCP Server。服务器成功启动后,将开始监听指定的端口。
  2. 安装 UI Assist 浏览器扩展: 安装与该服务器配套的 UI Assist 浏览器扩展(请参考 Glutamate 平台或仓库文档获取扩展的安装方式)。确保浏览器扩展已启用并可以连接到服务器。
  3. 配置 MCP 客户端: 在你的 LLM 应用或 MCP 客户端中,配置连接到 UI Assist MCP Server。使用上面生成的 JSON 配置信息。确保客户端使用 SSE 协议与服务器通信。
  4. 调用工具: 在 LLM 应用中,你可以调用以下工具来与网页 UI 元素交互:
    • 'get_selected_elements': 调用此工具,服务器会通过浏览器扩展获取当前选中的 HTML 元素信息,并将结果返回给 LLM。
    • 'clear_selected_elements': 调用此工具,服务器会指示浏览器扩展清除当前选中的 HTML 元素列表。

通过以上步骤,你的 LLM 应用就可以利用 Glutamate UI Assist MCP Server 提供的能力,与网页 UI 元素进行交互,从而实现更丰富的应用场景,例如网页信息提取、UI 自动化辅助等。

信息

分类

开发者工具