Claude代码会话搜索MCP服务器
MCP（模型上下文协议）服务器，提供用于搜索和分析Claude Code对话历史的工具。
特性
- 列出项目：查看所有具有会话计数的Claude Code项目
- 列出会话：浏览特定项目的会话
- 列出最近的会话：查找所有项目的最新对话
- 分析会话：使用角色筛选提取和分析消息
- 搜索对话：使用上下文窗口搜索特定术语
- 获取消息详细信息：检索特定邮件的完整内容
安装
- 安装依赖项：
uv pip install -e .- 克隆此存储库：
git clone https://github.com/bwads001/cc-session-search.git
cd cc-session-search- 添加到克劳德代码MCP配置(
~/.config/claude/mcp.json):
{
"servers": {
"cc-session-search": {
"command": ["uv", "run", "cc-session-search"],
"cwd": "${HOME}/cc-session-search"
}
}
}注意：调整 cwd 路径，以匹配您克隆存储库的位置。
用法
服务器提供以下工具：
list_projects（）
列出所有带有会话计数和最近活动的Claude Code项目。
list_sessions（项目名称，日期返回=7）
列出指定时间范围内特定项目的会话。
list_recent_sessions（days_back=1，project_filter=无）
列出所有项目的最近会话。
analyze_sessions（days_back=1，role_filter=“both”，include_tools=False，project_filter=无）
使用筛选选项从会话中提取和分析消息。
search_conversations（查询，days_back=2，context_window=1，case_sensitive=False，project_filter=无）
使用上下文窗口搜索对话中的特定术语。
get_message_details（会话id、消息id）
通过会话ID和索引检索特定消息的完整内容。
发展
服务器使用官方MCP Python SDK构建，具有低级server类，可实现最大控制。
主要特点：
- 通过内容截断实现高效的响应处理
- 最小化令牌使用的元数据优先方法
- 支持日期范围和筛选
- 跨项目搜索功能
许可证
麻省理工学院