MCP Browser Console Capture Service

概述

MCP Browser Console Capture Service 是一个基于 FastMCP 框架的浏览器自动化服务，专门用于智能舆情分析系统。该服务提供了完整的浏览器控制、JavaScript 执行、控制台日志捕获和页面交互功能。

技术栈

• FastMCP: MCP (Model Context Protocol) 服务框架
• Selenium: 浏览器自动化工具
• Chrome: 主要支持的浏览器
• ChromeDriver: Chrome 浏览器驱动程序
• Python 3.10.12+: 运行环境

核心功能

🌐 浏览器控制

• 启动和管理 Chrome/Firefox 浏览器实例
• 页面导航和 URL 访问
• 窗口大小调整和管理
• 多会话支持

📝 JavaScript 执行

• 在页面中执行自定义 JavaScript 代码
• 获取执行结果和返回值
• 支持异步脚本执行

📊 控制台日志捕获

• 实时捕获浏览器控制台日志
• 支持多种日志级别（INFO、WARNING、ERROR、DEBUG）
• 结构化日志数据返回
• 可配置日志数量限制（最多10000条）

🎯 页面交互

• 元素点击和文本输入
• 元素等待和条件检查
• 页面截图功能
• Cookie 和页面信息获取

🔐 认证机制

• 支持 `test-token-eric` 特殊认证
• 默认管理员权限
• 完整的操作日志记录

环境配置步骤

1. 系统要求

# Ubuntu/Debian 系统
sudo apt update
sudo apt install -y python3 python3-pip python3-venv

# 安装必要的系统依赖
sudo apt install -y wget unzip curl

2. Chrome 浏览器 和 ChromeDriver 安装

重要： 本服务需要特定路径的 Chrome 浏览器

3. ChromeDriver 安装

重要： ChromeDriver 版本必须与 Chrome 版本匹配

Google Chrome for Testing 137.0.7151.119

ChromeDriver 137.0.7151.119 (e0ac9d12dff5f2d33c935958b06bf1ded7f1c08c-refs/branch-heads/7151@{#2356})

请自行下载安装：json 源地址

https://googlechromelabs.github.io/chrome-for-testing/last-known-good-versions-with-downloads.json

验证安装

/opt/chromedriver-linux64/chromedriver --version

/opt/chrome-linux64/chrome --version

配置到对应路径到server.py

4. Python 环境配置

创建虚拟环境

python3 -m venv venv
source venv/bin/activate

安装依赖

pip install -r requirements.txt

安装 FastMCP（如果不在 requirements.txt 中）

pip install fastmcp

5. 配置文件设置

确保 `config.json` 中的路径配置正确：

{
  "mcpServers": {
    "browser-console-capture": {
      "command": "/home/cooper/IntelligentPublicSentimentSystem/mcp_services/browser_console_capture/server.py",
      "args": [],
      "env": {
        "PYTHONPATH": "/home/cooper/IntelligentPublicSentimentSystem"
      }
    }
  }
}

6. 权限设置

# 确保 Chrome 和 ChromeDriver 有执行权限
sudo chmod +x /opt/chrome-linux64/chrome
sudo chmod +x /opt/chromedriver-linux64/chromedriver

# 创建必要的目录
mkdir -p ./screenshots
mkdir -p ./logs

7. 环境验证

# 测试 Chrome 启动
/opt/chrome-linux64/chrome --version --no-sandbox

# 测试 ChromeDriver
/opt/chromedriver-linux64/chromedriver --version

# 测试 Python 依赖
python3 -c "import selenium; print('Selenium version:', selenium.__version__)"
python3 -c "import fastmcp; print('FastMCP imported successfully')"

启动服务

fastmcp run server.py:mcp

IntelligentPublicSentimentSystem/mcp_services/browser_console_capture$ fastmcp run server.py:mcp

2025-06-20 03:02:09,006 - server_module - INFO - 日志系统初始化完成，配置已加载

2025-06-20 03:02:09,010 - auth_utils - INFO - === 浏览器MCP认证配置 ===

2025-06-20 03:02:09,010 - auth_utils - INFO - 默认用户: eric

2025-06-20 03:02:09,010 - auth_utils - INFO - 默认角色: admin

2025-06-20 03:02:09,010 - auth_utils - INFO - 特殊Token: test-token-eric

2025-06-20 03:02:09,011 - auth_utils - INFO - 浏览器MCP将自动使用eric用户身份进行认证

2025-06-20 03:02:09,011 - auth_utils - INFO - ==========================

2025-06-20 03:02:09,011 - server_module - INFO - 初始化FastMCP服务器...

2025-06-20 03:02:09,016 - server_module - INFO - FastMCP服务器初始化完成

2025-06-20 03:02:09,017 - server_module - INFO - 状态字典初始化完成

使用示例

基本浏览器操作

# 启动浏览器
start_browser(browser_type="chrome", headless=False)

# 导航到页面
navigate_to_url("https://example.com")

# 执行 JavaScript
execute_javascript("console.log('Hello World'); return document.title;")

# 获取控制台日志
get_console_logs(level="ALL", limit=100)

页面交互

# 点击元素
click_element("#submit-button", by="css")

# 输入文本
input_text("#search-input", "搜索内容", by="css")

# 等待元素
wait_for_element(".loading-complete", condition="visible")

# 截图
take_screenshot("page_screenshot.png", full_page=True)

配置说明

浏览器配置

• `chrome_binary_path`: Chrome 浏览器可执行文件路径
• `chromedriver_path`: ChromeDriver 可执行文件路径
• `headless`: 是否以无头模式运行
• `window_size`: 浏览器窗口大小

日志配置

• `log_level`: 日志级别（DEBUG, INFO, WARNING, ERROR）
• `log_file`: 日志文件路径
• `max_log_size`: 最大日志文件大小

性能配置

• `page_load_timeout`: 页面加载超时时间
• `script_timeout`: 脚本执行超时时间
• `implicit_wait`: 隐式等待时间

MCP工具函数

安全注意事项

1. 生产环境配置

2. 认证安全

需要有token的情况

贡献指南

1. Fork 项目

2. 创建功能分支

3. 提交更改

4. 创建 Pull Request

许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

联系方式

如有问题或建议，请通过以下方式联系：

• 项目 Issues: [GitHub Issues]()
• 邮箱: [项目邮箱]()
• 文档: [在线文档]()