使用说明

项目简介

browser-use MCP server 是一个基于 Model Context Protocol (MCP) 的后端应用，旨在演示如何构建一个简单的笔记管理服务。该服务器允许用户通过LLM客户端添加、存储、检索和总结笔记。它通过MCP协议的标准接口向客户端暴露笔记资源、操作工具和Prompt模板，使得LLM应用能够方便地利用这些功能进行交互。

主要功能点

资源 (Resources):
- 提供笔记资源的管理和访问。
- 使用自定义 'note://' URI 方案访问特定笔记。
- 每个笔记资源包含名称、描述和 'text/plain' MIME类型。
Prompt 模板 (Prompts):
- 提供 'summarize-notes' Prompt模板，用于总结所有存储的笔记。
- 支持可选的 'style' 参数（'brief'/'detailed'）来控制总结的详细程度。
工具 (Tools):
- 提供 'add-note' 工具，用于向服务器添加新的笔记。
- 接受 'name' 和 'content' 作为必需的字符串参数。
- 添加笔记后，服务器状态更新并通知客户端资源已更改。

安装步骤

该MCP服务器是一个Python项目，可以使用 'uv' 包管理器进行依赖管理和构建。

安装 'uv' (如果尚未安装): 请参考 uv installation guide 安装 'uv'。

克隆仓库: 从 GitHub 克隆 'browser-use' 仓库到本地。

git clone https://github.com/adamdude828/mcp-browser-use
cd mcp-browser-use

同步依赖: 使用 'uv sync' 命令安装项目依赖。
```
uv sync
```

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要提供服务器的启动命令和参数。以下是配置示例，通常需要添加到 MCP 客户端的配置文件中（例如 'claude_desktop_config.json'）。

开发/未发布服务器配置 (Development/Unpublished Servers Configuration)

用于开发环境，直接运行项目目录中的服务器代码。

{
  "mcpServers": {
    "browser-use": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-browser-use",  //  请替换为您的 'browser-use' 仓库的本地路径
        "run",
        "browser-use"
      ]
    }
  }
}

请注意: 将 '/path/to/mcp-browser-use' 替换为您实际克隆的 'browser-use' 仓库的本地绝对路径。

发布服务器配置 (Published Servers Configuration)

用于已发布的服务器，假设服务器已打包并可通过 'uvx' 运行。

{
  "mcpServers": {
    "browser-use": {
      "command": "uvx",
      "args": [
        "browser-use"
      ]
    }
  }
}

基本使用方法

启动 MCP 服务器: 根据您选择的配置方式（开发或发布），MCP 客户端将使用您提供的命令和参数来启动 'browser-use' MCP 服务器。
在 LLM 客户端中使用: 一旦服务器成功配置并启动，您就可以在支持 MCP 协议的 LLM 客户端中使用 'browser-use' 服务器提供的功能了。例如：
- 使用 'add-note' 工具添加笔记。
- 使用 'summarize-notes' Prompt模板总结笔记。
- 通过 'note://' URI 访问和读取特定笔记资源。
具体的调用方式取决于您使用的 LLM 客户端的界面和操作方式。通常，您可以在客户端中找到可用的工具和Prompt模板列表，并选择使用它们。资源 URI 可能在需要时由客户端自动处理或提示用户输入。

关键词