Chrome历史记录和书签MCP服务器
一个模型上下文协议（MCP）服务器，为AI助手提供分析Chrome浏览器历史和书签数据的工具。
特性
🔍 历史搜索 -按关键字、URL和日期范围搜索Chrome浏览历史记录\ 📊 历史统计 -了解您的浏览数据，包括日期范围和访问次数\ ⏰ 最近浏览 -查看最近24小时的浏览活动（可配置）\ 🔖 书签访问 -阅读和分析Chrome书签（即将推出）\ 📈 浏览模式 -分析浏览习惯和模式（即将推出）\ 📤 数据导出 -将历史记录和书签导出为各种格式（即将推出）
安装
- 克隆存储库：
git clone https://github.com/your-username/chrome-history-mcp-server.git
cd chrome-history-mcp-server- 安装依赖项：
npm install- 运行服务器：
node src/mcp-server.js使用Claude Desktop
- 配置Claude桌面 通过编辑配置文件：
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json\ 窗户： %APPDATA%/Claude/claude_desktop_config.json
- 添加MCP服务器配置：
{
"mcpServers": {
"chrome-history": {
"command": "node",
"args": ["/path/to/your/project/src/mcp-server.js"],
"env": {}
}
}
}- 重新启动克劳德桌面 开始使用这些工具！
可用工具
search_history
使用可选的日期过滤功能搜索Chrome浏览历史记录。
示例用法：
"Search my browser history for 'github'"
"Find all YouTube videos I watched last week"
"Show me what I browsed between 2024-01-01 and 2024-01-31"get_recent_browsing
获取最近几个小时的浏览活动，包括访问详细信息和时间戳。
示例用法：
"Show me what I've been browsing in the last 24 hours"
"What websites did I visit in the last 6 hours?"get_history_stats
获取有关Chrome历史数据库的统计信息，包括日期范围和总条目。
示例用法：
"Show me my Chrome history statistics"
"What's the date range of my browsing history?"运作原理
此MCP服务器：
- 查找Chrome -跨平台（macOS、Windows、Linux）自动查找Chrome配置文件目录
- 读取SQLite数据库 -以只读模式安全访问Chrome的历史数据库
- 提供工具 -通过标准化的MCP工具公开浏览数据
- 交叉平台的 -适用于Chrome、Chromium和各种Chrome配置文件
建筑
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Claude │ │ MCP Server │ │ Chrome │
│ Desktop │◄──►│ (This Project) │◄──►│ Browser │
│ (AI Client) │ │ │ │ SQLite DB │
└─────────────────┘ └──────────────────┘ └─────────────────┘技术细节
- 语言： JavaScript（ES模块）
- 协议： 模型上下文协议（MCP）
- 数据库： SQLite3（Chrome的历史数据库）
- 平台： macOS、Windows、Linux
- Chrome支持： 铬、铬、多种配置文件
安全与隐私
- 只读访问 -从不修改Chrome数据
- 本地处理 -所有数据都保留在您的机器上
- 无网络请求 -完全离线操作
- 数据库安全 -使用SQLite只读模式防止损坏
需求
- Node.js 16+支持ES模块
- 铬/铬 安装并运行至少一次
- MCP兼容客户端 （如克劳德桌面）
贡献
欢迎投稿！请随时提交问题和拉取请求。
许可证
MIT许可证-有关详细信息，请参阅许可证文件。
故障排除
“未找到Chrome安装”
- 确保Chrome已安装并至少运行过一次
- 检查您是否使用自定义Chrome配置文件位置
“数据库查询失败”
- 确保Chrome已关闭（数据库可能已锁定）
- 验证Chrome配置文件权限
“日期范围没有结果”
- 使用
get_history_stats检查可用日期范围 - 确保日期格式为YYYY-MM-DD
未来功能
- 🔖 完整书签分析和搜索
- 📊 高级浏览模式分析
- 📤 导出为JSON、CSV、HTML格式
- 🧹 注重隐私的历史记录清理工具
- 📈 浏览时间分析和见解