Stagehand MCP Server
2025.04.30
0
TypeScript网页自动化AI 驱动交互浏览器自动化
Stagehand MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，提供 AI 驱动的网页自动化能力。它允许大型语言模型 (LLMs) 在真实的浏览器环境中与网页交互，执行操作、提取数据并观察可能的操作。该服务器支持多种工具和资源，包括导航、操作、数据提取和观察等，适用于需要自动化网页交互的场景。
View on GitHub
Overview
基本能力
产品定位
Stagehand MCP Server 是一个 AI 驱动的网页自动化工具，旨在通过 MCP 协议为 LLMs 提供网页交互能力。
核心功能
- 网页导航：通过
stagehand_navigate工具导航到指定 URL。 - 网页操作：通过
stagehand_act工具执行网页操作（如点击按钮）。 - 数据提取：通过
stagehand_extract工具从网页中提取结构化数据。 - 观察操作：通过
stagehand_observe工具观察网页上可执行的操作。 - 资源访问：提供控制台日志和截图资源。
适用场景
- 自动化网页测试
- 数据抓取和提取
- 网页交互模拟
- AI 驱动的网页操作
工具列表
- stagehand_navigate：导航到指定 URL。
- stagehand_act：执行网页操作。
- stagehand_extract：从网页提取数据。
- stagehand_observe：观察网页上的可操作元素。
常见问题解答
- 依赖问题：确保已安装 Node.js 和 npm。
- 环境变量：必须设置
BROWSERBASE_API_KEY、BROWSERBASE_PROJECT_ID和OPENAI_API_KEY。 - 调试：启用
DEBUG环境变量以查看详细日志。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
安装教程
- 运行
npm install安装依赖。 - 运行
npm run build生成dist/index.js。 - 配置 Claude Desktop 以使用该服务器。
{
"mcpServers": {
"stagehand": {
"command": "node",
"args": ["path/to/mcp-server-stagehand/dist/index.js"],
"env": {
"BROWSERBASE_API_KEY": "<YOUR_BROWSERBASE_API_KEY>",
"BROWSERBASE_PROJECT_ID": "<YOUR_BROWSERBASE_PROJECT_ID>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
}
}
}
}
- 重启 Claude Desktop 应用。
调试方式
- 启用
DEBUG环境变量以查看详细日志。 - 检查控制台日志和截图资源以调试问题。