会话历史搜索服务

Claude会话历史搜索服务提供模糊搜索、会话浏览和摘要检索功能,适用于开发者和团队管理会话历史。

  • by TheTechChild
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 TheTechChild/claude-session-search

使用说明

Claude会话搜索MCP服务器

用于搜索和浏览Claude Code会话历史的MCP服务器。

特性

一级工具

  1. 搜索_提示 -在所有用户提示中进行模糊搜索
  2. list_sessions -使用过滤器和排序浏览会话
  3. get_session -检索完整的会话记录(JSON或Markdown)
  4. get_session_summary -获取会话摘要和元数据

安装

cd ~/angel-studios/.claude/mcp-servers/claude-session-search
yarn install
yarn build

发展

yarn dev

配置

集 CLAUDE_HOME 用于覆盖默认值的环境变量 ~/.claude 位置。

会话历史架构

Claude Code将会话历史存储在两层中:

全球提示指数

  • 位置: ~/.claude/history.jsonl
  • 格式:每行一个JSON对象,带有提示、时间戳和项目

完整会议记录

  • 位置: ~/.claude/projects/{encoded-path}/{session-uuid}.jsonl
  • 格式:每行一个JSON对象,包含消息、摘要和元数据

工具使用示例

搜索提示

mcp__claude-session-search__search_prompts({
  query: "GraphQL",
  project: "angel-studios",
  limit: 10
})

列出会话

mcp__claude-session-search__list_sessions({
  project: "angel-studios",
  sortBy: "date",
  sortOrder: "desc",
  limit: 20
})

获取会话

mcp__claude-session-search__get_session({
  sessionId: "01d8a33b-7ac1-48bb-83cc-56ec4a9167b1",
  format: "markdown"
})

获取会话摘要

mcp__claude-session-search__get_session_summary({
  sessionId: "01d8a33b-7ac1-48bb-83cc-56ec4a9167b1"
})