浏览器自动化MCP服务器

为AI模型(如Claude和Gemini 2.5)提供浏览器自动化功能的MCP服务器,通过自然语言实现网页浏览和交互。

  • by jasondsmith72
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 jasondsmith72/browser-use-claude-mcp

使用说明

浏览器使用claude mcp

适用于Claude和Gemini 2.5等AI模型的浏览器自动化MCP服务器,通过自然语言实现网页浏览功能。

概述

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

主要特点

🌐 浏览器自动化功能

  • 完全的浏览器自动化(导航、表单填写、点击等)
  • 网络搜索功能
  • 截图以便于视觉理解
  • 内容提取和分析

🤖 AI功能

  • 支持多个AI提供商:
    • 谷歌双子座2.5(主要焦点)
    • 人物克劳德
    • OpenAI
  • 图像分析(视觉)能力
  • 基于AI的内容分析

🔧 技术特性

  • 用TypeScript编写,以获得最大的可靠性
  • 模块化架构,关注点清晰分离
  • 全面的日志记录和错误处理
  • 通过环境变量轻松配置

可用工具

工具名称 描述
browse_webpage 导航到URL并提取其内容
search_web 执行网络搜索并返回结果
take_screenshot 捕获当前页面的屏幕截图
click_element 按文本或选择器单击元素
fill_form 用提供的值填写表单字段
extract_content 从网页中提取特定内容
analyze_content 基于AI的网页内容分析

入门指南

看 安装.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配置文件:

    • 窗户: %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以使更改生效。

例子

基本Web浏览

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"
)

发展

# Run in development mode
npm run dev

# Run tests
npm test

# Lint code
npm run lint

许可证

麻省理工学院

鸣谢

该项目建立在浏览器使用和其他MCP服务器实现的基础上。