项目简介

Blueprint MCP 是一款创新的 MCP 服务器，旨在解决传统无头浏览器自动化工具（如 Playwright 或 Puppeteer）在AI代理应用中面临的挑战。它通过一个浏览器扩展，让 AI 助手能够直接控制您的真实浏览器（Chrome、Firefox、Edge 或 Opera），利用您已登录的会话、Cookie 和现有扩展程序，从而有效避免机器人检测，并提供更真实的网页交互体验。

主要功能点

真实浏览器控制: AI 助手能够操作您本地已安装的浏览器，而非无头或独立的浏览器实例，保留所有用户配置。
会话保持: 无需重复登录，AI 即可访问您已登录的网站。
网页导航与管理: 支持打开、关闭、切换标签页，导航至指定 URL，以及前进/后退浏览历史。
页面内容读取: 获取页面可访问内容（DOM 快照）、捕获视觉截图、提取页面为 Markdown 格式。
富交互操作: 模拟用户点击、输入文本、悬停、拖拽、选择下拉选项、填写表单、按下键盘按键。
网络活动监控: 强大的网络请求监控工具，支持列出、查看详情、JSONPath 过滤甚至重放请求。
高级自动化: 执行页面 JavaScript 代码、处理浏览器弹窗（alert/confirm/prompt）、模拟文件上传、调整浏览器窗口大小、保存页面为 PDF。
扩展程序管理: 列出已安装的浏览器扩展，或重新加载开发中的扩展。
AI集成: 提供标准化的工具接口，使各类 AI 模型（如 Claude、GPT）能够无缝调用上述浏览器功能。

安装步骤

安装 Blueprint MCP 服务器

打开您的终端或命令行工具，运行以下命令全局安装：

npm install -g @railsblueprint/blueprint-mcp

安装浏览器扩展程序
- 根据您使用的浏览器选择安装方式：
  - Chrome / Edge / Opera:
    - 从 Chrome 网上应用店安装。
    - 或者，从 Releases 页面下载扩展文件手动加载。
  - Firefox:
    - 从 Firefox Add-ons 安装。
    - 或者，从 Releases 页面下载扩展文件手动加载。

服务器配置

要将 Blueprint MCP 服务器与您的 MCP 客户端（如 Claude Desktop, VS Code / Cursor）连接，您需要更新客户端的配置。以下是一个常见的 JSON 配置示例，用于告知客户端如何启动并连接到 Blueprint MCP：

{
  "mcpServers": {
    "browser": { // 为您的 MCP 客户端定义一个名称（例如“browser”），AI 助手将使用此名称来调用浏览器相关功能。
      "command": "npx", // 启动 Blueprint MCP 服务器的命令，通常是“npx”来运行 npm 包。
      "args": ["@railsblueprint/blueprint-mcp@latest"] // 传递给启动命令的参数，指定要运行的 Blueprint MCP 包。
    }
  }
}

请将上述 JSON 配置片段添加到您的 MCP 客户端的配置文件中：

Claude Desktop: '~/Library/Application Support/Claude/claude_desktop_config.json'
VS Code / Cursor: '.vscode/settings.json'

基本使用方法

启动您的 MCP 客户端: 启动任何支持 MCP 的 AI 客户端（例如 Claude Desktop 或 Cursor）。
点击浏览器扩展图标: 在您的浏览器中，点击 Blueprint MCP 扩展程序的图标。扩展程序会自动连接到正在运行的 MCP 服务器。
开始向 AI 助手提问: 您现在可以开始向您的 AI 助手发送指令，让它控制浏览器执行各种网页操作。

示例对话:

您: "去 GitHub 看看我的通知。"
- AI: （导航到 github.com，点击通知，读取内容）
您: "用我的信息填写这个表格。"
- AI: （读取表单字段，填写并提交）
您: "给我截取这个页面的屏幕快照。"
- AI: （捕获屏幕快照并显示给您）

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息