mcp-chrome-server

🚀 MCP Chrome 服务器

一款基于 MCP（模型 - 控制器 - 提示）的浏览器自动化 Chrome 服务器，可实现浏览器自动化控制、多会话管理等功能，支持跨平台使用，还具备插件扩展兼容性。

🚀 快速开始

本服务器需满足一定的先决条件并完成安装和配置，即可开启使用。

✨ 主要特性

MCP Chrome Server 提供以下主要功能：

1. 浏览器自动化控制
2. 多会话管理
3. 跨平台支持
4. 插件扩展兼容性

📦 安装指南

先决条件

• 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 浏览器以获取最新安全补丁
• 配置完成后建议进行访问控制测试

💻 使用示例

基础用法

启动服务器

uv run mcp-chrome-server

配置参数

• --port：指定服务监听端口，默认为 8080
• --profile：指定 Chrome 配置文件目录，默認為 $HOME/.config/google-chrome

🔧 技术细节

错误处理

常见错误

1. Connection Refused：服务器未启动或端口被占用
2. Profile Not Found：指定的配置文件路径不存在
3. Version Mismatch：Chrome 版本不兼容

解决方案

1. 确保服务器已正确启动
2. 检查配置文件路径是否正确
3. 使用与系统兼容的 Chrome 版本

📄 联系方式

• 邮件：support@dlwjdtn535.com
• GitHub：github.com/dlwjdtn535/mcp-chrome-server