MCP Chrome Server

MCP Chrome 服务

基于 MCP（模型-控制器-提示词）的 Chrome 服务，用于浏览器自动化。

安装

前置条件

• Python 3.12
• 已安装 Google Chrome 浏览器
• uv（Python 软件包安装程序）或 Docker

通过 Smithery 安装

npx -y @smithery/cli install @dlwjdtn535/mcp-chrome-server --client claude

配置设置

根据你的环境选择以下一种设置方法：

1. 使用 uv（推荐）

Windows 设置：

{
  "mcpServers": {
    "mcp-chrome-server": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "%LOCALAPPDATA%\\Programs\\mcp-chrome-server\\src",
        "mcp-chrome-server"
      ],
      "env": {
        "CHROME_PROFILE_PATH": "%LOCALAPPDATA%\\Google\\Chrome\\User Data"
      }
    }
  }
}

macOS 设置：

{
  "mcpServers": {
    "mcp-chrome-server": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/usr/local/bin/mcp-chrome-server/src",
        "mcp-chrome-server"
      ],
      "env": {
        "CHROME_PROFILE_PATH": "$HOME/Library/Application Support/Google/Chrome"
      }
    }
  }
}

Linux 设置：

{
  "mcpServers": {
    "mcp-chrome-server": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/usr/local/bin/mcp-chrome-server/src",
        "mcp-chrome-server"
      ],
      "env": {
        "CHROME_PROFILE_PATH": "$HOME/.config/google-chrome"
      }
    }
  }
}

配置

Chrome 配置文件路径

各操作系统的默认 Chrome 配置文件路径：

操作系统	路径
Windows	%LOCALAPPDATA%\Google\Chrome\User Data
macOS	~/Library/Application Support/Google/Chrome
Linux	~/.config/google-chrome

重要说明

• 启动自动化服务前，请关闭所有正在运行的 Chrome 实例
• 确保对 Chrome 配置文件目录拥有适当的权限
• 使用 Docker 设置时，请确保卷挂载路径与系统的 Chrome 配置文件路径一致

凭据管理

使用系统钥匙串安全地存储和管理登录信息：

# Save credentials
result = tool_save_credentials(
    site="example.com",
    username="your_username",
    password="your_password"
)

# Retrieve saved credentials
result = tool_get_credentials(
    site="example.com",
    username="your_username"
)

主要功能

浏览器控制

# Open browser
result = tool_open_browser()

# Navigate to URL
result = tool_navigate(url="https://example.com")

# Close browser
result = tool_close_browser()

网页登录

result = tool_web_login(
    url="https://example.com/login",
    credentials={
        "username": "your_username",
        "password": "your_password"
    },
    selectors={
        "username": "#id",
        "password": "#pw",
        "submit": ".login-button"
    }
)

特殊处理：

• 检测到 CAPTCHA 时，等待用户完成验证
• 自动检测双重身份验证
• 详细分析登录失败的情况

元素操作

# Click element
result = tool_click(selector=".button")

# Type text
result = tool_type(
    selector="#input-field",
    text="Hello, World!"
)

# Get text
result = tool_get_text(selector=".content")

# Get multiple elements
result = tool_get_elements(selector=".items")

重要注意事项

1. Chrome 配置文件使用

   • 确认配置了正确的配置文件路径
   • 关闭所有使用该配置文件的其他 Chrome 窗口

2. 防止自动化检测

   • 模拟自然的用户行为
   • 在登录尝试之间保持适当的间隔

3. 安全性

   • 重要凭据始终使用系统钥匙串存储
   • 切勿在环境变量或配置文件中直接暴露凭据