opensource/mcp-chrome
3
0
Fork 0
mirror of https://github.com/hangwin/mcp-chrome.git synced 2026-08-29 01:53:10 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
d25a0fbecbacaec585f568dfb19cf9f9fbcf03be
mcp-chrome/README_zh.md
T
hangerye d25a0fbecb feat: add console tool & support mcp stdio type
2025-06-22 21:45:17 +08:00

9.3 KiB
Raw Blame History

Chrome MCP Server 🚀

许可证: MIT TypeScript Chrome 扩展

🌟 让chrome浏览器变成你的智能助手 - 让AI接管你的浏览器，将您的浏览器转变为强大的 AI 控制自动化工具。

📖 文档: English | 中文

🎯 什么是 Chrome MCP Server？

Chrome MCP Server 是一个基于chrome插件的 模型上下文协议 (MCP) 服务器，它将您的 Chrome 浏览器功能暴露给 Claude 等 AI 助手，实现复杂的浏览器自动化、内容分析和语义搜索等。与传统的浏览器自动化工具（如playwright）不同，Chrome MCP server直接使用您日常使用的chrome浏览器，基于现有的用户习惯和配置、登录态，让各种大模型或者各种chatbot都可以接管你的浏览器，真正成为你的如常助手

✨ 核心特性

  • 😁 chatbot/模型无关：让任意你喜欢的llm或chatbot客户端或agent来自动化操作你的浏览器
  • ⭐️ 使用你原本的浏览器：无缝集成用户本身的浏览器环境（你的配置、登录态等）
  • 💻 完全本地运行：纯本地运行的mcp server，保证用户隐私
  • 🚄 Streamable http：Streamable http的连接方式
  • 🏎 跨标签页 跨标签页的上下文
  • 🧠 语义搜索：内置向量数据库和本地小模型，智能发现浏览器标签页内容
  • 🔍 智能内容分析：AI 驱动的文本提取和相似度匹配
  • 🌐 20+ 工具：支持截图、网络监控、交互操作、书签管理、浏览历史等20多种工具
  • 🚀 SIMD 加速 AI：自定义 WebAssembly SIMD 优化，向量运算速度提升 4-8 倍

🆚 与同类项目对比

对比维度 基于Playwright的MCP Server 基于Chrome插件的MCP Server
资源占用 ❌ 需启动独立浏览器进程，需要安装Playwright依赖，下载浏览器二进制等 ✅ 无需启动独立的浏览器进程，直接利用用户已打开的Chrome浏览器
用户会话复用 ❌ 需重新登录 ✅ 自动使用已登录状态
浏览器环境保持 ❌ 干净环境缺少用户设置 ✅ 完整保留用户环境
API访问权限 ⚠️ 受限于Playwright API ✅ Chrome原生API全访问
启动速度 ❌ 需启动浏览器进程 ✅ 只需激活插件
响应速度 50-200ms进程间通信 ✅ 更快

🚀 快速开始

环境要求

  • Node.js 18+ 和 pnpm
  • Chrome/Chromium 浏览器

安装步骤

  1. 从github上下载最新的chrome扩展

下载地址：https://github.com/hangwin/mcp-chrome/releases

  1. 全局安装mcp-chrome-bridge

npm

npm install -g mcp-chrome-bridge

pnpm

pnpm install -g mcp-chrome-bridge --unsafe-perm

注意：使用 pnpm 安装时需要添加 --unsafe-perm 参数以确保安装后脚本能正常执行，这对于注册 Native Messaging 主机是必要的。

  1. 加载 Chrome 扩展
    • 打开 Chrome 并访问 chrome://extensions/
    • 启用"开发者模式"
    • 点击"加载已解压的扩展程序"，选择 your/dowloaded/extension/folder
    • 点击插件图标打开插件，点击连接即可看到mcp的配置 截屏2025-06-09 15 52 06

在 Claude Desktop 中使用

将以下配置添加到 Claude Desktop 的 MCP 配置中：

{
  "mcpServers": {
    "streamable-mcp-server": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:12306/mcp"
    }
  }
}

🛠️ 可用工具

完整工具列表：完整工具列表

📊 浏览器管理 (6个工具)
  • get_windows_and_tabs - 列出所有浏览器窗口和标签页
  • chrome_navigate - 导航到 URL 并控制视口
  • chrome_close_tabs - 关闭特定标签页或窗口
  • chrome_go_back_or_forward - 浏览器导航控制
  • chrome_inject_script - 向网页注入内容脚本
  • chrome_send_command_to_inject_script - 向已注入的内容脚本发送指令
📸 截图和视觉 (1个工具)
  • chrome_screenshot - 高级截图捕获，支持元素定位、全页面和自定义尺寸
🌐 网络监控 (4个工具)
  • chrome_network_capture_start/stop - webRequest API 网络捕获
  • chrome_network_debugger_start/stop - Debugger API 包含响应体
  • chrome_network_request - 发送自定义 HTTP 请求
🔍 内容分析 (4个工具)
  • search_tabs_content - AI 驱动的浏览器标签页语义搜索
  • chrome_get_web_content - 从页面提取 HTML/文本内容
  • chrome_get_interactive_elements - 查找可点击元素
  • chrome_console - 捕获和获取浏览器标签页的控制台输出
🎯 交互操作 (3个工具)
  • chrome_click_element - 使用 CSS 选择器点击元素
  • chrome_fill_or_select - 填充表单和选择选项
  • chrome_keyboard - 模拟键盘输入和快捷键
📚 数据管理 (5个工具)
  • chrome_history - 搜索浏览器历史记录，支持时间过滤
  • chrome_bookmark_search - 按关键词查找书签
  • chrome_bookmark_add - 添加新书签，支持文件夹
  • chrome_bookmark_delete - 删除书签

🧪 使用示例

ai帮你总结网页内容然后自动控制excalidraw画图

prompt: excalidraw-prompt 指令：帮我总结当前页面内容，然后画个图帮我理解

https://github.com/user-attachments/assets/f14f79a6-9390-4821-8296-06d020bcfc07

ai先分析图片的内容元素，然后再自动控制excalidraw把图片模仿出来

prompt: excalidraw-prompt|content-analize 指令：先看下图片是否能用excalidraw画出来，如果则列出所需的步骤和元素，然后画出来

https://github.com/user-attachments/assets/4f0600c1-bb1e-4b57-85ab-36c8bdf71c68

ai自动帮你注入脚本并修改网页的样式

prompt: modify-web-prompt 指令：帮我修改当前页面的样式，去掉广告

https://github.com/user-attachments/assets/aedbe98d-e90c-4a58-a4a5-d888f7293d8e

ai自动帮你捕获网络请求

指令：我想知道小红书的搜索接口是哪个，响应体结构是什么样的

https://github.com/user-attachments/assets/063f44ae-1754-46b6-b141-5988c86e4d96

ai帮你分析你的浏览记录

指令：分析一下我近一个月的浏览记录

https://github.com/user-attachments/assets/e7a35118-e50e-4b1c-a790-0878aa2505ab

网页对话

指令：翻译并总结当前网页

https://github.com/user-attachments/assets/08aa86aa-7706-4df2-b400-576e2c7fcc7f

ai帮你自动截图（网页截图）

指令：把huggingface的首页截个图

https://github.com/user-attachments/assets/b081e41b-6309-40d6-885b-0da01691b12e

ai帮你自动截图（元素截图）

指令：把huggingface首页的图标截取下来

https://github.com/user-attachments/assets/25657076-b84b-4459-a72f-90f896f06364

ai帮你管理书签

指令：将当前页面添加到书签中，放到合适的文件夹

https://github.com/user-attachments/assets/73c1ea26-65fb-4b5e-b537-e32fa9bcfa52

自动关闭网页

指令：关闭所有shadcn相关的网页

https://github.com/user-attachments/assets/ff160f48-58e0-4c76-a6b0-c4e1f91370c8

🤝 贡献指南

我们欢迎贡献！请查看 CONTRIBUTING_zh.md 了解详细指南。

🚧 未来发展路线图

我们对 Chrome MCP Server 的未来发展有着激动人心的计划：

  • 身份认证

  • 录制与回放

  • 工作流自动化

  • 增强浏览器支持（Firefox 扩展）

想要为这些功能中的任何一个做贡献？ 查看我们的贡献指南并加入我们的开发社区！

📄 许可证

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

📚 更多文档

Reference in New Issue View Git Blame Copy Permalink