AI导哈

浏览器历史分析服务

一个提供AI助手分析Chrome浏览器历史和书签数据的MCP服务器。

  • by ananddharne
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ananddharne/chrome-history-mcp-server

使用说明

Chrome历史记录和书签MCP服务器

一个模型上下文协议（MCP）服务器，为AI助手提供分析Chrome浏览器历史和书签数据的工具。

特性

🔍 历史搜索 -按关键字、URL和日期范围搜索Chrome浏览历史记录
📊 历史统计 -了解您的浏览数据，包括日期范围和访问次数
⏰ 最近浏览 -查看最近24小时的浏览活动（可配置）
🔖 书签访问 -阅读和分析Chrome书签（即将推出）
📈 浏览模式 -分析浏览习惯和模式（即将推出）
📤 数据导出 -将历史记录和书签导出为各种格式（即将推出）

安装

  1. 克隆存储库：

    git clone https://github.com/your-username/chrome-history-mcp-server.git
cd chrome-history-mcp-server

  2. 安装依赖项：

    npm install

  3. 运行服务器：

    node src/mcp-server.js

使用Claude Desktop

  1. 配置Claude桌面 通过编辑配置文件：

    macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
    窗户： %APPDATA%/Claude/claude_desktop_config.json

  2. 添加MCP服务器配置：

    {
  "mcpServers": {
    "chrome-history": {
      "command": "node",
      "args": ["/path/to/your/project/src/mcp-server.js"],
      "env": {}
    }
  }
}

  3. 重新启动克劳德桌面 开始使用这些工具！

可用工具

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服务器：

  1. 查找Chrome -跨平台（macOS、Windows、Linux）自动查找Chrome配置文件目录
  2. 读取SQLite数据库 -以只读模式安全访问Chrome的历史数据库
  3. 提供工具 -通过标准化的MCP工具公开浏览数据
  4. 交叉平台的 -适用于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格式
  • 🧹 注重隐私的历史记录清理工具
  • 📈 浏览时间分析和见解

相关 MCP