Browser-use-claude-mcp

Browser-use-claude-mcp

面向 Claude 和 Gemini 2.5 等 AI 模型的浏览器自动化 MCP 服务，通过自然语言提供网页浏览功能。

概览

本项目实现了一个 Model Context Protocol（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 文件中的环境变量配置服务：

# Browser configuration
CHROME_PATH=
CHROME_USER_DATA=
CHROME_DEBUGGING_PORT=9222

# AI provider (GEMINI, ANTHROPIC, OPENAI)
MCP_MODEL_PROVIDER=GEMINI

# API keys (use the one for your chosen provider)
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": "[email protected]",
  "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"
)

开发

# Run in development mode
npm run dev

# Run tests
npm test

# Lint code
npm run lint

许可证

MIT

致谢

本项目基于 browser-use 及其他 MCP 服务实现的成果构建。