🚀 浏览器历史记录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文件。