MCP 服务器

Chrome History & Bookmarks MCP Server

Enables AI assistants to search and analyze Chrome browser history and bookmarks data locally, including keyword searches, date range filtering, recent browsing activity, and usage statistics across all platforms.

README

Chrome History & Bookmarks MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with tools to analyze Chrome browser history and bookmarks data.

Features

🔍 History Search - Search through Chrome browsing history by keywords, URLs, and date ranges
📊 History Statistics - Get insights about your browsing data including date ranges and visit counts
⏰ Recent Browsing - View recent browsing activity from the last 24 hours (configurable)
🔖 Bookmarks Access - Read and analyze Chrome bookmarks (coming soon)
📈 Browsing Patterns - Analyze browsing habits and patterns (coming soon)
📤 Data Export - Export history and bookmarks to various formats (coming soon)

Installation

Clone the repository:

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

Install dependencies:
```
npm install
```
Run the server:
```
node src/mcp-server.js
```

Usage with Claude Desktop

Configure Claude Desktop by editing your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Add the MCP server configuration:

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

Restart Claude Desktop and start using the tools!

Available Tools

`search_history`

Search through Chrome browsing history with optional date filtering.

Example usage:

"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`

Get browsing activity from recent hours with visit details and timestamps.

Example usage:

"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`

Get statistics about your Chrome history database including date ranges and total entries.

Example usage:

"Show me my Chrome history statistics"
"What's the date range of my browsing history?"

How It Works

This MCP server:

Locates Chrome - Automatically finds Chrome profile directory across platforms (macOS, Windows, Linux)
Reads SQLite Database - Safely accesses Chrome's History database in read-only mode
Provides Tools - Exposes browsing data through standardized MCP tools
Cross-Platform - Works with Chrome, Chromium, and various Chrome profiles

Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Claude        │    │   MCP Server     │    │   Chrome        │
│   Desktop       │◄──►│   (This Project) │◄──►│   Browser       │
│   (AI Client)   │    │                  │    │   SQLite DB     │
└─────────────────┘    └──────────────────┘    └─────────────────┘