内容
# Browser-use-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编写，以确保最大可靠性
- 模块化架构，关注点清晰分离
- 完善的日志记录和错误处理
- 通过环境变量轻松配置
## 可用工具
| 工具名称 | 描述 |
|-----------|-------------|
| `browse_webpage` | 导航到一个URL并提取其内容 |
| `search_web` | 执行网络搜索并返回结果 |
| `take_screenshot` | 捕获当前页面的截图 |
| `click_element` | 根据文本或选择器点击一个元素 |
| `fill_form` | 用提供的值填写表单字段 |
| `extract_content` | 从网页中提取特定内容 |
| `analyze_content` | AI驱动的网页内容分析 |
## 开始使用
请参见[INSTALL.md](INSTALL.md)以获取详细的安装和设置说明。
### 快速开始
1. 克隆代码库
```bash
git clone https://github.com/jasondsmith72/Browser-use-claude-mcp.git
cd Browser-use-claude-mcp
```
2. 安装依赖
```bash
npm install
```
3. 创建一个`.env`文件（使用`.env.example`作为模板）
```bash
cp .env.example .env
```
4. 构建项目
```bash
npm run build
```
5. 启动服务器
```bash
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服务器添加到您的配置中：
```json
{
"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="总结过去十年AI的主要发展"
)
```
## 开发
```bash
# 在开发模式下运行
npm run dev
# 运行测试
npm test
# 代码检查
npm run lint
```
## 许可证
MIT
## 致谢
该项目基于browser-use和其他MCP服务器实现的工作。
MCP 市场