Browser-use-claude-mcp

一个用于 AI 模型（如 Claude 和 Gemini 2.5）的浏览器自动化 MCP 服务器，通过自然语言实现网页浏览功能。

概述

本项目实现了一个模型上下文协议 (MCP) 服务器，为 AI 模型提供浏览器自动化功能。它允许 AI 助手使用自然语言命令浏览网页、与网站交互以及提取信息。

主要特性

🌐 浏览器自动化特性

• 完整的浏览器自动化（导航、表单填写、点击等）
• 网页搜索功能
• 屏幕截图捕获，用于视觉理解
• 内容提取和分析

🤖 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 驱动的网页内容分析

快速上手

请参阅 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 文件中的环境变量配置服务器：

# 浏览器配置
CHROME_PATH=
CHROME_USER_DATA=
CHROME_DEBUGGING_PORT=9222

# AI 提供商 (GEMINI, ANTHROPIC, OPENAI)
MCP_MODEL_PROVIDER=GEMINI

# API 密钥（使用您选择的提供商的密钥）
GOOGLE_API_KEY=your_google_api_key_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here
OPENAI_API_KEY=your_openai_api_key_here

与 Claude Desktop 一起使用

1. 找到 Claude Desktop 配置文件：

   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. 将此 MCP 服务器添加到您的配置中：

   {
     "mcpServers": {
       "browser-use-claude-mcp": {
         "command": "node",
         "args": [
           "/path/to/Browser-use-claude-mcp/dist/index.js"
         ],
         "env": {
           "CHROME_PATH": "",
           "CHROME_USER_DATA": "",
           "MCP_MODEL_PROVIDER": "GEMINI",
           "GOOGLE_API_KEY": "your_google_api_key_here"
         }
       }
     }
   }
   

3. 重新启动 Claude Desktop 以使更改生效。

示例

基本网页浏览

browse_webpage(url="https://example.com")

网页搜索

search_web(query="best programming languages 2025")

填写表单

fill_form(fields={
  "name": "John Doe",
  "email": "john@example.com",
  "message": "Hello world!"
}, submit=true)

AI 内容分析

analyze_content(
  url="https://en.wikipedia.org/wiki/Artificial_intelligence",
  instructions="Summarize the key developments in AI in the last decade"
)

开发

# 在开发模式下运行
npm run dev

# 运行测试
npm test

# 检查代码风格
npm run lint

许可证

MIT

鸣谢

本项目基于 browser-use 和其他 MCP 服务器实现的工作。