Browser History MCP

🚀 浏览器历史记录MCP服务器

这是一个本地的模型上下文协议（MCP）服务器，可提供对浏览器历史记录数据的访问，用于全面分析并获取洞察。该工具基于官方Python MCP SDK构建，按照快速开始指南，只需几分钟即可将其集成到Claude桌面应用中。

📋 目录

• 主要特性
• 快速开始
• 安装指南
• 配置说明
• API文档
• 浏览器支持情况
• 故障排除
• 隐私与安全
• 许可证

✨ 主要特性

• 🔍 多浏览器支持：可查询Firefox、Chrome和（部分版本的）Safari浏览器的历史记录。
• 📊 会话分析：通过智能的基于时间的聚类对浏览会话进行分组。
• 🏷️ 智能分类：自动根据类型和用途对网站进行分类。
• 📈 域名分析：分析域名访问频率和访问模式。
• 🎯 学习洞察：识别学习模式和教育内容的消费情况。
• ⚡ 生产力指标：计算生产力得分并进行分心分析。
• 🔄 实时访问：直接访问数据库以立即获取洞察。
• 🛡️ 隐私优先：本地处理，无需数据传输。

🚀 快速开始

1. 安装用于依赖管理的uv：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   uv sync
   

2. 本地测试：

   uv run mcp dev server/main.py
   

3. 安装到Claude桌面应用（之后需要重启Claude桌面应用）：

   uv run mcp install server/main.py --name "Browser History MCP"
   

📦 详细安装步骤

前提条件

• Python 3.12或更高版本
• Firefox、Chrome或Safari浏览器
• uv（推荐）或pip

使用uv（推荐）

# 若尚未安装uv，则进行安装
curl -LsSf https://astral.sh/uv/install.sh | sh

# 克隆并安装
git clone https://github.com/yourusername/browser-mcp-server.git
cd browser-mcp-server
uv sync

使用pip

git clone https://github.com/yourusername/browser-mcp-server.git
cd browser-mcp-server
pip install -e .

⚙️ 配置

自动设置（推荐）

服务器会自动检测你的浏览器配置文件目录：

手动配置

如果自动检测失败，请在server/main.py中手动配置路径：

FIREFOX_PROFILE_DIR = "/path/to/your/firefox/profile"
CHROME_PROFILE_DIR = "/path/to/your/chrome/profile"

开发模式

uv run mcp dev server/main.py

专业提示：打开预填充了令牌的本地URL版本，然后点击“连接”。

与Claude桌面应用配合使用

uv run mcp install server/main.py --name "Browser History MCP"

📚 API文档

核心工具

分析提示

🌐 浏览器支持情况

重要提示：由于文件锁定机制，必须关闭浏览器才能访问其历史记录数据库。

故障排除

MCP配置

{
  "mcpServers": {
    "Browser History MCP": {
      "command": "/usr/local/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "[wherever-you-saved-the-repo]/browser-mcp-server/server/main.py"
      ]
    }
  }
}

🔒 隐私与安全

数据处理

• 本地处理：所有数据处理都在你的本地机器上进行。
• 无数据传输：除了Claude桌面应用可能进行的操作外，不会将浏览器历史记录数据发送到外部服务器。
• 直接数据库访问：直接从浏览器的SQLite数据库中读取数据。
• 临时缓存：可选的本地缓存以提高性能。

📄 许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。