使用说明
浏览器使用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 有关详细的安装和设置说明。
快速开始
-
克隆存储库
git clone https://github.com/jasondsmith72/Browser-use-claude-mcp.git cd Browser-use-claude-mcp -
安装依赖项
npm install -
创建一个
.env文件(使用.env.example作为模板)cp .env.example .env -
构建项目
npm run build -
启动服务器
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一起使用
-
找到Claude Desktop配置文件:
- 窗户:
%APPDATA%/Claude/claude_desktop_config.json - MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- 窗户:
-
将此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" } } } } -
重新启动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服务器实现的基础上。