Browser History MCP

🚀 瀏覽器歷史記錄MCP服務器

這是一個本地的模型上下文協議（MCP）服務器，可提供對瀏覽器歷史記錄數據的訪問，用於全面分析並獲取洞察。該工具基於官方Python MCP SDK構建，按照快速開始指南，只需幾分鐘即可將其集成到Claude桌面應用中。

📋 目錄

• 主要特性
• 快速開始
• 安裝指南
• 配置說明
• API文檔
• 瀏覽器支持情況
• 故障排除
• 隱私與安全
• 許可證

✨ 主要特性

• 🔍 多瀏覽器支持：可查詢Firefox、Chrome和（部分版本的）Safari瀏覽器的歷史記錄。
• 📊 會話分析：通過智能的基於時間的聚類對瀏覽會話進行分組。
• 🏷️ 智能分類：自動根據類型和用途對網站進行分類。
• 📈 域名分析：分析域名訪問頻率和訪問模式。
• 🎯 學習洞察：識別學習模式和教育內容的消費情況。
• ⚡ 生產力指標：計算生產力得分並進行分心分析。
• 🔄 即時訪問：直接訪問數據庫以立即獲取洞察。
• 🛡️ 隱私優先：本地處理，無需數據傳輸。

🚀 快速開始

1. 安裝用於依賴管理的uv：

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

2. 本地測試：

   uv run mcp dev server/main.py
   

3. 安裝到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 .

⚙️ 配置

自動設置（推薦）

服務器會自動檢測你的瀏覽器配置文件目錄：

手動配置

如果自動檢測失敗，請在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文檔

核心工具

分析提示

🌐 瀏覽器支持情況

重要提示：由於文件鎖定機制，必須關閉瀏覽器才能訪問其歷史記錄數據庫。

故障排除

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