Scan to join WeChat grouparticle
README
🚀 搜索历史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：获取你访问最频繁的网站
📦 安装指南
- 安装 Claude Desktop
- 安装 uv
- 克隆或导航至本仓库
- 配置环境：
uv venv && uv pip install -r pyproject.toml && uv pip install cryptography && source .venv/bin/activate - 安装MCP服务器：
fastmcp install claude-desktop mcp_server.py - 重启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系统。
根据你的文件结构，可能需要手动配置浏览器文件路径。