MCP Chrome Server

🚀 MCP Chrome 服務器

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 配置文件路徑：

重要注意事項

⚠️ 重要提示

• 啟動自動化服務器前關閉所有正在運行的 Chrome 實例
• 確保 Chrome 配置文件目錄具有適當的權限
• 對於 Docker 設置，請確保卷掛載路徑正確無誤

💡 使用建議

• 不要將敏感信息直接寫入配置文件
• 定期更新 Chrome 瀏覽器以獲取最新安全補丁
• 配置完成後建議進行訪問控制測試

✨ 主要特性

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

1. 瀏覽器自動化控制
2. 多會話管理
3. 跨平臺支持
4. 插件擴展兼容性

💻 使用示例

基礎用法

# 啟動服務器
uv run mcp-chrome-server

高級用法

# 指定服務監聽端口為 8888，指定 Chrome 配置文件目錄
uv run mcp-chrome-server --port 8888 --profile /path/to/your/chrome/profile

配置參數

• --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