返回 MCP 目录
public公开dns本地运行

Browser-use-claude-mcp

一个为AI模型提供浏览器自动化能力的MCP服务器,支持Claude和Gemini等模型通过自然语言指令进行网页浏览、搜索和交互操作。

article

README

🚀 浏览器使用Claude MCP

本项目是一个为AI模型(如Claude和Gemini 2.5)实现浏览器自动化的MCP服务器,可通过自然语言指令提供网页浏览功能,让AI助手能更智能地与网页交互。

🚀 快速开始

本项目实现了Model Context Protocol(MCP)协议的服务器端,赋予AI模型浏览器自动化的能力,使AI助手能够通过自然语言命令浏览网页、与网站交互并提取信息。

详细安装步骤

参见INSTALL.md获取详细的安装和设置说明。以下是快速开始指南:

  1. 克隆仓库
    git clone https://github.com/jasondsmith72/Browser-use-claude-mcp.git
    cd Browser-use-claude-mcp
    
  2. 安装依赖项
    npm install
    
  3. 创建.env文件(以.env.example为模板)
    cp .env.example .env
    
  4. 构建项目
    npm run build
    
  5. 启动服务器
    npm start
    

配置说明

参考.env.example文件,可通过环境变量进行配置。例如:

  • CHROME_PATH:指定Chrome浏览器的路径
  • HEADLESS_CHROME:是否启用无头模式(true/false)

在Claude Desktop中使用

在Claude Desktop中使用本项目,请按照以下步骤操作:

  1. 打开配置文件,通常位于~/.config/claude/settings.json
  2. 添加MCP服务器配置:
    {
      "mcpServers": [
        {
          "name": "Browser Use Claude",
          "url": "http://localhost:3000"
        }
      ]
    }
    
  3. 启动Claude Desktop并选择新添加的MCP服务器

✨ 主要特性

🌐 浏览器自动化功能

  • 具备完整的浏览器自动化能力,涵盖导航、表单填写、点击等操作。
  • 支持网页搜索功能。
  • 可进行页面截图,以便获取视觉理解。
  • 能够进行内容提取和分析。

🤖 AI相关功能

  • 支持多种AI提供商:
    • Google Gemini 2.5(主要支持)
    • Anthropic Claude
    • OpenAI
  • 支持图像分析(视觉处理)。
  • 具备AI驱动的内容分析能力。

🔧 技术特性

  • 使用TypeScript编写,确保代码可靠性。
  • 采用模块化架构,职责分离明确。
  • 拥有全面的日志记录和错误处理机制。
  • 环境变量配置简单易用。

📦 可用工具

| 工具名称 | 描述 | |----------|------| | browse_webpage | 访问指定URL并提取其内容 | | search_web | 执行网页搜索并返回结果 | | take_screenshot | 捕获当前页面的截图 | | click_element | 通过文本或选择器点击元素 | | fill_form | 填写表单字段,使用提供的值 | | extract_content | 从网页中提取特定内容 | | analyze_content | 对网页内容进行AI分析 |

💻 使用示例

基础用法

浏览网页

// 示例:访问Google
await browserUseClaude.browseWeb('https://www.google.com');

搜索功能

// 示例:搜索“人工智能”
await browserUseClaude.searchWeb('人工智能');

📚 开发与测试

  1. 以开发模式运行
    npm run dev
    
  2. 执行测试
    npm test
    
  3. 运行Linter检查代码风格
    npm run lint
    

📄 许可证

项目采用MIT License

致谢

感谢社区和开源项目的贡献,使此项目得以实现。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端