AI导哈

会话搜索工具

一个用于搜索和分析Claude Code对话历史的MCP服务器，提供项目列表、会话浏览、消息分析和全文搜索等功能。

  • by bwads001
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 bwads001/cc-session-search

使用说明

Claude代码会话搜索MCP服务器

MCP（模型上下文协议）服务器，提供用于搜索和分析Claude Code对话历史的工具。

特性

  • 列出项目：查看所有具有会话计数的Claude Code项目
  • 列出会话：浏览特定项目的会话
  • 列出最近的会话：查找所有项目的最新对话
  • 分析会话：使用角色筛选提取和分析消息
  • 搜索对话：使用上下文窗口搜索特定术语
  • 获取消息详细信息：检索特定邮件的完整内容

安装

  1. 安装依赖项：
uv pip install -e .
  1. 克隆此存储库：
git clone https://github.com/bwads001/cc-session-search.git
cd cc-session-search
  1. 添加到克劳德代码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类，可实现最大控制。

主要特点：

  • 通过内容截断实现高效的响应处理
  • 最小化令牌使用的元数据优先方法
  • 支持日期范围和筛选
  • 跨项目搜索功能

许可证

麻省理工学院

相关 MCP