AI导哈

浏览器自动化服务器

一个基于Playwright的浏览器自动化服务器，提供网页导航、内容提取、截图和页面交互功能。

  • by Sumitbhoyar
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Sumitbhoyar/mcp

使用说明

MCP实践-MCP服务器集合

此存储库包含一组MCP（模型上下文协议）服务器，每个服务器为AI助手提供不同的功能。

📦 可用服务器

🎭 剧作家浏览器(servers/playwright-browser)

使用Playwright的浏览器自动化服务器。浏览网站、提取内容、截图并与网页交互。

特征：

  • 导航到URL
  • 提取页面内容（文本或HTML）
  • 获取页面标题
  • 截图
  • 单击元素，键入文本，等待选择器

看 服务器/剧作家浏览器/README.md 详细文档。

🚀 快速开始

安装

  1. 安装所有依赖项：
npm run install:all
  1. 安装Playwright浏览器（用于剧作家浏览器服务器）：
npm run setup:playwright

或者为特定服务器安装依赖关系：

cd servers/playwright-browser
npm install
npx playwright install chromium

⚙️ 配置

用于游标IDE

Cursor使用位于以下位置的MCP配置文件：

  • 窗户： %USERPROFILE%\.cursor\mcp.json （例如。， C:\Users\YourName\.cursor\mcp.json)
  • macOS/Linux： ~/.cursor/mcp.json

快速设置（Windows）

  1. 自动设置： 运行提供的PowerShell脚本：

    powershell -ExecutionPolicy Bypass -File setup-cursor-config.ps1

  2. 手动设置： 在以下位置创建或编辑文件 C:\Users\YourName\.cursor\mcp.json 并添加：

    {
  "mcpServers": {
    "playwright-browser": {
      "command": "node",
      "args": [
        "C:\\path\\to\\mcp-practice\\servers\\playwright-browser\\src\\server.js"
      ],
      "cwd": "C:\\path\\to\\mcp-practice\\servers\\playwright-browser"
    }
  }
}

    重要提示： 替换 C:\\path\\to\\mcp-practice 带有项目目录的实际路径。

快速设置（macOS/Linux）

  1. 如果目录不存在，请创建该目录：

    mkdir -p ~/.cursor

  2. 创建或编辑 ~/.cursor/mcp.json:

    {
  "mcpServers": {
    "playwright-browser": {
      "command": "node",
      "args": [
        "/full/path/to/mcp-practice/servers/playwright-browser/src/server.js"
      ],
      "cwd": "/full/path/to/mcp-practice/servers/playwright-browser"
    }
  }
}

配置后

  1. 重新启动游标 完全为了使更改生效
  2. 当您使用浏览器相关提示时，MCP服务器将自动启动
  3. 通过尝试以下操作验证其是否正常工作：“导航到https://example.com并总结页面”

适用于Claude Desktop（替代方案）

如果您使用的是Claude Desktop：

  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json

📝 添加新的MCP服务器

要添加新的MCP服务器，请执行以下操作：

  1. 在下创建新目录 servers/:

    mkdir servers/your-server-name
mkdir servers/your-server-name/src

  2. 创建 package.json 在新的服务器目录中，使用：

    • 服务器特定依赖关系
    • A. start 指向服务器入口点的脚本

  3. 在中创建服务器实现 servers/your-server-name/src/server.js

  4. 更新 setup-cursor-config.ps1 将新服务器包含在配置中

  5. 在中添加文档 servers/your-server-name/README.md

🏗️ 项目结构

mcp-practice/
├── servers/                    # All MCP servers
│   ├── playwright-browser/    # Playwright browser automation server
│   │   ├── src/
│   │   │   └── server.js      # Server implementation
│   │   ├── package.json       # Server dependencies
│   │   └── README.md          # Server documentation
│   └── [future servers...]    # Add more servers here
├── package.json               # Root workspace configuration
├── setup-cursor-config.ps1    # Cursor configuration setup script
├── cursor-mcp-config.json     # Example Cursor config
├── mcp-config.json            # Example MCP config
└── README.md                  # This file

📚 使用示例

Playwright浏览器服务器

配置后，您可以使用以下提示：

  • “导航到https://example.com并对页面进行总结。"
  • 首选https://example.com并获取页面标题。"
  • “截图https://example.com"
  • “导航到https://example.com，单击带有选择器“#submit”的按钮，告诉我发生了什么。"

🔧 发展

直接运行服务器

要直接测试服务器，请执行以下操作：

cd servers/playwright-browser
npm start

或者：

node servers/playwright-browser/src/server.js

注意：服务器通过stdio进行通信，因此它们被设计为由MCP客户端使用，而不是独立运行。

📄 许可证

麻省理工学院

相关 MCP