浏览器使用Claude MCP

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

概述

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

核心特性

🌐 浏览器自动化功能

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

🤖 AI相关功能

• 支持多种AI提供商：
  • Google Gemini 2.5（主要支持）
  • Anthropic Claude
  • OpenAI
• 图像分析（视觉处理）
• AI驱动的内容分析

🔧 技术特性

• 使用TypeScript编写以确保可靠性
• 模块化架构，职责分离明确
• 全面的日志记录和错误处理
• 环境变量配置简单易用

可用工具

快速入门

参见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服务器

示例用法

浏览网页

// 示例：访问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。

致谢

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