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ファイルを参照してください。