项目简介

'gomcp' 是一个基于Go语言实现的Model Context Protocol (MCP) 服务器，旨在为大型语言模型(LLM)客户端提供与Lightpanda浏览器交互的能力。它将浏览器操作封装为MCP工具，允许LLM通过标准化的协议访问网页内容和功能。

主要功能点

• 浏览器自动化工具: 提供工具，允许LLM控制浏览器执行操作，如导航到指定URL。
• 网页内容提取: 能够提取当前加载页面的内容，并转换为易于处理的Markdown格式。
• 链接查找: 可以列出当前页面上的所有链接。
• MCP协议支持: 遵循Model Context Protocol规范，通过JSON-RPC协议与客户端通信。
• 多种传输方式: 支持Stdio（标准输入/输出）和SSE（Server-Sent Events）两种传输协议，方便与不同类型的LLM客户端集成。
• 内置浏览器管理: 可选地自动下载并运行Lightpanda浏览器本地实例，无需手动启动浏览器。

安装步骤

1. 安装Go语言: 请确保您的系统已安装Go开发环境。
2. 克隆仓库: 使用'git clone https://github.com/lightpanda-io/gomcp.git'克隆项目代码。
3. 进入目录: 'cd gomcp'
4. 构建二进制文件: 运行'go build'命令生成'gomcp'可执行文件。
5. 下载浏览器 (可选): 如果您希望使用内置的Lightpanda浏览器，请运行 './gomcp download'。这会将浏览器下载到用户配置目录。您也可以使用'./gomcp cleanup'移除下载的浏览器。

服务器配置

MCP客户端（如某些桌面版LLM应用）需要配置MCP服务器的启动信息。通常需要提供服务器的名称、启动命令及其参数。

对于 'gomcp'，配置信息如下：

• 服务器名称 (server name): 例如 'lightpanda'
• 启动命令 (command): 'gomcp' 可执行文件的完整路径，例如 '/path/to/gomcp'
• 参数 (args): 根据您希望使用的传输协议选择：
  • '["stdio"]': 使用Stdio协议启动。
  • '["sse"]': 使用SSE协议启动，默认监听地址为 '127.0.0.1:8081'。可以通过 '--api-addr' 参数指定其他地址，例如 '["--api-addr", "127.0.0.1:8082", "sse"]'。
  • '["--cdp", "ws://127.0.0.1:9222", "stdio"]' 或 '["--cdp", "ws://127.0.0.1:9222", "sse"]': 连接到一个已经运行的远程Lightpanda浏览器（或支持CDP的浏览器）实例。'ws://127.0.0.1:9222' 是CDP连接地址。

请将这些信息填入您的MCP客户端的配置文件中（具体位置和格式取决于客户端应用）。

基本使用方法

• 作为Stdio服务器运行 (通常用于桌面应用集成): 在终端运行 './gomcp stdio'。服务器将通过标准输入/输出与客户端通信。
• 作为SSE服务器运行 (通常用于基于HTTP的客户端): 在终端运行 './gomcp sse'。服务器将在 '127.0.0.1:8081' (默认) 启动一个HTTP服务，通过SSE和POST请求与客户端通信。

您可以根据需要通过命令行参数配置服务器行为，例如使用 '--cdp' 连接到外部浏览器。