browser-mcp

基本能力

产品定位

browser-mcp 是一个浏览器扩展和 MCP 服务器的组合，旨在通过提供一系列工具来增强浏览器的功能，使用户能够更高效地与浏览器交互。

核心功能

1. 获取当前页面的 Markdown 内容：可以从当前浏览的页面提取 Markdown 格式的内容。
2. 添加 CSS 样式：允许用户向当前页面添加自定义的 CSS 样式，例如实现暗黑模式。
3. 搜索浏览器历史记录：可以搜索浏览器的历史记录，快速找到之前访问过的页面。

适用场景

1. 内容摘要：快速获取当前页面的摘要或总结。
2. 页面定制：根据需要调整页面的样式，如切换暗黑模式。
3. 历史记录管理：快速查找之前访问过的页面或资源。

工具列表

1. get_current_page_markdown：获取当前浏览页面的 Markdown 内容。
2. append_style：向当前页面添加 CSS 样式。
3. history_search：搜索浏览器的历史记录。

常见问题解答

暂无提供。

使用教程

使用依赖

安装前需要确保已安装 Node.js 和 pnpm。

# 安装 pnpm（如果尚未安装）
npm install -g pnpm

安装教程

1. 克隆项目并安装依赖：

pnpm i

1. 构建扩展：

cd extension

# 构建 Chrome 扩展
npm run build

# 构建 Edge 扩展
npm run build:edge

# 构建 Firefox 扩展
npm run build:firefox

构建完成后，扩展文件将位于 extension/.output 目录中。

1. 构建服务器：

cd server

# 开发模式
npm run dev

# 构建生产版本
npm run build

服务器入口文件为 server/dist/cli.js。

调试方式

1. 启动开发服务器：

cd server
npm run dev

1. 使用提供的工具进行测试，例如：

Summarize the current page.

或

Change the current page to dark mode.

贡献指南

添加新工具

1. 在 server/src/tools.ts 的 tools 数组中添加工具的模式。
2. 在 extension/calls.ts 中添加一个可调用的扩展处理程序。
3. 在 server/src/tools.ts 中添加一个工具处理程序。使用 call 函数调用扩展处理程序。

许可证

该项目遵循 AGPL-3.0-or-later 开源许可条款。