Search History MCP

🚀 搜索历史MCP

通过适用于大语言模型（LLM）聊天应用的MCP服务器，访问并搜索你的浏览器搜索历史（支持Brave、Chrome、Firefox、Safari、Edge、Arc、Opera、DuckDuckGo）。该项目支持MacOS、Windows和Linux系统。

点击查看相关资源

🚀 快速开始

该项目允许你借助MCP服务器，方便地访问和搜索浏览器的搜索历史。你可以按照以下步骤进行操作。

✨ 主要特性

此MCP服务器提供了三种与搜索历史进行交互的工具：

• search_history：在URL和页面标题中搜索特定术语
• get_recent_history：获取最新的浏览历史记录
• get_most_visited：获取你访问最频繁的网站

📦 安装指南

1. 安装 Claude Desktop
2. 安装 uv
3. 克隆或导航至本仓库
4. 配置环境：uv venv && uv pip install -r pyproject.toml && uv pip install cryptography && source .venv/bin/activate
5. 安装MCP服务器：fastmcp install claude-desktop mcp_server.py
6. 重启Claude Desktop

💻 使用示例

基础用法

该项目提供了多种实用的工具与搜索历史交互，以下是一些简单示例，展示如何调用这些工具。

# 搜索特定术语
# 假设已经正确配置并启动了MCP服务器
# 使用search_history工具搜索特定术语
# 这里需要根据实际的API调用方式进行操作，示例代码仅为示意
result = search_history("特定搜索术语")
print(result)

# 获取最新的浏览历史记录
recent_history = get_recent_history()
print(recent_history)

# 获取最常访问的网站
most_visited = get_most_visited()
print(most_visited)

高级用法

在实际应用中，你可以结合这些工具实现更复杂的功能，例如基于搜索历史进行项目头脑风暴。

# 假设我们要根据搜索历史进行项目头脑风暴
# 首先获取相关的搜索历史
relevant_history = search_history("项目相关关键词")

# 然后根据这些历史记录进行一些处理，这里只是简单示例
# 例如将历史记录中的关键词提取出来
import re
keywords = []
for entry in relevant_history:
    # 简单的关键词提取逻辑，根据实际情况调整
    matches = re.findall(r'\w+', entry)
    keywords.extend(matches)

# 打印提取的关键词，用于后续的头脑风暴
print("提取的关键词:", keywords)

📚 详细文档

使用场景

• 头脑风暴：受你的兴趣和搜索历史启发，进行项目创意的头脑风暴。
• 大语言模型个性化支持：让你的大语言模型更了解你。
• 个人资料生成：根据你的搜索历史构建个人资料。

隐私说明

此服务器以只读模式读取你本地的浏览器历史数据库。为避免浏览器运行时的锁定问题，它会创建临时副本。对于macOS上的DuckDuckGo，加密密钥会从你的macOS钥匙串中获取，仅用于解密你本地的历史数据。除了发送到你本地的大语言模型聊天应用外，不会将任何数据发送到其他地方。

浏览器支持：Windows、macOS和Linux系统支持Brave、Chrome、Edge、Opera、Arc和DuckDuckGo浏览器。所有平台均支持Firefox浏览器。Safari浏览器仅支持macOS系统。

根据你的文件结构，可能需要手动配置浏览器文件路径。