金大哥 - browser_history

article

README

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

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

📋 目录

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

✨ 主要特性

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

🚀 快速开始

安装用于依赖管理的uv：

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

本地测试：
```
uv run mcp dev server/main.py
```
安装到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 .

⚙️ 配置

自动设置（推荐）

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

| 操作系统 | Firefox路径 | Chrome路径 | |------|------|------| | macOS | ~/Library/Application Support/Firefox/Profiles/[profile-id].default-release | ~/Library/Application Support/Google/Chrome/Default | | Linux | ~/.mozilla/firefox/[profile-id].default-release | ~/.config/google-chrome/Default | | Windows | %APPDATA%\Mozilla\Firefox\Profiles\[profile-id].default-release | %LOCALAPPDATA%\Google\Chrome\User Data\Default |

手动配置

如果自动检测失败，请在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文档

核心工具

| 工具 | 描述 | 使用场景 | |------|------|------| | health_check | 简单的健康检查，用于测试MCP服务器是否正常工作 | 初始测试 | | check_browser_status | 步骤1：检查哪些浏览器可用，哪些被锁定 | 初始设置和故障排除 | | get_browser_history | 步骤2：获取原始浏览器历史记录数据，不进行分析（最快） | 快速数据检索 | | analyze_browser_history | 步骤3：主要分析工具，可选择快速摘要、基本或全面分析 | 全面的生产力分析 | | search_browser_history | 在浏览器历史记录中搜索特定查询 | 有针对性的研究 | | suggest_categories | 获取未分类的URL，用于自定义分类 | 数据组织 | | diagnose_safari_support | Safari支持和可访问性诊断 | Safari特定问题 |

分析提示

| 提示 | 目的 | 输出 | |------|------|------| | productivity_analysis | 全面的生产力评估 | 生产力指标和建议 | | learning_analysis | 深入的学习模式分析 | 学习洞察和进度跟踪 | | research_topic_extraction | 研究主题提取和总结 | 研究主题和重点领域 | | generate_insights_report | 创建个性化的浏览洞察 | 全面的活动和行为报告 | | compare_time_periods | 比较不同时间段的浏览习惯 | 趋势分析和习惯转变指标 | | export_visualization | 生成数据可视化 | 交互式图表和可视化分析 |

🌐 浏览器支持情况

| 浏览器 | 状态 | 要求 | |------|------|------| | Firefox | ✅ 完全支持 | 浏览器必须关闭 | | Chrome | ✅ 完全支持 | 浏览器必须关闭 | | Safari | 🔄 有限支持 | 主要是较旧版本的Safari |

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

故障排除

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文件。

browser_history_mcp