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类，可实现最大控制。

主要特点：

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

许可证

麻省理工学院